Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
Contributing
Thanks for your interest in contributing!
Getting Started
- Fork the repo and create a feature branch
- Install the CLI with
uv tool install vibe - Run
vibeto complete the setup UI
Development
- Run locally: build and maintain Show Runtime separately, point
VIBE_SHOW_RUNTIME_BINat that build's entry point, then runpython main.py. - Retired managed GitHub-source checkouts under
<runtime_dir>/source/github/are no longer used after an upgrade. They can be removed manually after confirming thatVIBE_SHOW_RUNTIME_BINdoes not point inside that directory. - Build an installable local wheel: build
ui/, runpython scripts/prepare_local_show_runtime_manifest.py, then runuv build --wheel. The preparation step inherits the latest official release's SHA256-verified Show Runtime manifest; packaging fails closed when the manifest is missing or invalid. - Lint before PR: ruff is configured with a minimal safety rule set (E9,F63,F7,F82) and ignores E501. Install hooks with
pip install pre-committhenpre-commit install. Run manually withpre-commit run --all-files. - Write clear commit messages
- Agent-specific changes: install the relevant CLI (recommended: OpenCode
opencode; also supported: Codex), then route one Slack channel via Slack Agent Settings to manually test the backend (opencodeorcodex).
Pull Requests
- One logical change per PR
- Include description, screenshots/logs if UX/behavior changes
- Update docs/README if config or behavior changes
Code of Conduct
By participating, you agree to the CODE_OF_CONDUCT.md