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.
Codex Agent Setup
Avibe can route individual chat scopes to Codex instead of Claude Code. (OpenCode is also supported and recommended; see README for quick enablement.) This guide walks through enabling Codex end-to-end.
1. Install and authenticate Codex CLI
npm install -g @openai/codex
# or: brew install --cask codex
# or: download a release binary from https://github.com/openai/codex/releases
codex --help # verify installation
codex # sign in when prompted
Codex CLI must be available on the PATH of the host running Avibe. The bot automatically runs Codex with --json and --dangerously-bypass-approvals-and-sandbox, so make sure you trust the workspace it operates in.
2. Configure environment variables
In ~/.vibe_remote/config/config.json:
{
"agents": {
"codex": {
"enabled": true,
"cli_path": "codex"
}
}
}
Set the model on the Agents page. New Codex Agents without an explicit model are
prefilled with Avibe's release recommendation, and that value remains visible and
editable on the Agent. No additional flag is required to bypass approvals—the bot
always adds --dangerously-bypass-approvals-and-sandbox.
3. Route chats to Codex
Configure routing via the platform Agent Settings UI: pick Codex for the Slack channel, Discord channel, Telegram chat, or other scope you want.
Each routed scope stores a Vibe Agent name. Unrouted scopes fall back to the configured default Vibe Agent.
4. Restart the bot and test
vibe
In a routed chat, send a normal non-command message; you should see the bot acknowledge the request and then reply from Codex. For Telegram groups and forums, the default setup usually requires an explicit command, @mention, or reply-to-bot unless you already disabled require_mention. If the CLI is missing, the bot will reply with “Agent codex is not configured”.
5. Troubleshooting
- “Agent
codexis not configured”: ensurecodexCLI is installed and on PATH; checkCODEX_ENABLED. codex execerrors: inspect the latest~/.vibe_remote/logs/vibe_remote.logand the in-chat error details.- Routing not applied: confirm the target scope is the one you configured in Agent Settings for Slack, Discord, Telegram, or the relevant platform.