Installation
Prerequisites
Section titled “Prerequisites”Required
Section titled “Required”| Dependency | Version | Purpose |
|---|---|---|
| Rust | 1.92+ | Backend server |
| Node.js | 22+ | Frontend build |
| Claude Code CLI | Latest | AI agent execution |
Install Rust via rustup.rs. Install Claude Code:
npm install -g @anthropic-ai/claude-codeclaude loginOptional
Section titled “Optional”| Dependency | Purpose | Install |
|---|---|---|
| Codex CLI | OpenAI agent support | npm install -g @openai/codex |
| GitHub CLI | PR creation for GitHub repos | brew install gh && gh auth login |
| GitLab CLI | MR creation for GitLab repos | brew install glab && glab auth login |
| VS Code | ”Open in VS Code” button | Install code CLI via VS Code command palette |
Installation
Section titled “Installation”Clone the repository
Section titled “Clone the repository”git clone https://github.com/abbado-dev/abbado.gitcd abbadoStart the backend
Section titled “Start the backend”cargo runThis compiles and starts the Rust server on http://127.0.0.1:3000. On first run, it creates a SQLite database in ./data/.
Start the frontend
Section titled “Start the frontend”In a separate terminal:
cd frontendnpm installnpm run devThe frontend dev server starts on http://localhost:5173.
Using the Makefile
Section titled “Using the Makefile”For convenience, the Makefile runs both in parallel:
make dev # Backend + frontend in parallelmake test # Run all testsmake build # Production build (backend + frontend)Open http://localhost:5173 in your browser.
Environment Variables
Section titled “Environment Variables”| Variable | Default | Description |
|---|---|---|
IA_IDE_DATA_DIR | ./data | Directory for SQLite DB and worktrees |
IA_IDE_BIND | 127.0.0.1:3000 | Server bind address |
IA_IDE_FRONTEND_DIR | ./frontend/dist | Built frontend directory (production) |
RUST_LOG | abbado=debug | Log level (uses tracing crate) |
Example: run on a different port with a custom data directory:
IA_IDE_BIND=0.0.0.0:8080 IA_IDE_DATA_DIR=/opt/abbado/data cargo runVerify Installation
Section titled “Verify Installation”After starting both backend and frontend:
- Open
http://localhost:5173 - You should see the Abbado dashboard with an empty sidebar
- Click ”+ New Project” — if the form appears, the backend is connected
- Check the backend logs for
listening on 127.0.0.1:3000
Next Steps
Section titled “Next Steps”Continue to the Quick Start guide to create your first project and launch an agent session.