Skip to main content

Install for AI agents

This page is written for an AI coding agent helping a human install Avibe.

Rules

  • Ask before choosing a chat platform, agent backend, workspace, or credential value.
  • Do not guess secrets, bot tokens, app tokens, API keys, workspace IDs, or chat IDs.
  • Prefer the browser setup wizard launched by vibe over hand-editing config files.
  • Do not restart an already-running local vibe service unless the user confirms it is safe.
  • Keep setup local-first. Do not expose public webhooks unless the selected platform requires it.

1. Check the machine

On Windows, prefer WSL unless the user explicitly wants native PowerShell.

2. Install Avibe

macOS / Linux:
Open source — view the script on GitHub. The short URL is a 307 redirect to that file. Windows PowerShell:
Verify:

3. Install one coding agent

Ask the user which backend they want first. Recommended default:
  • OpenCode for low-friction setup.
  • Claude Code for deeper codebase work.
  • Codex for OpenAI workflows.
OpenCode:
Claude Code:
Codex:
Verify:

4. Start the setup wizard

Help the user choose:
  1. Chat platform.
  2. Agent backend.
  3. Project working directory.
  4. Channel or chat scopes that should be enabled.

5. Optional remote Web UI

If the user wants to open the local Web UI from another device:
Use this for Web UI access, not for exposing the agent runtime directly.

6. Smoke test

Ask the user to send:
Then verify:
If messages do not arrive: