Introduction

Abbado is a local dev cockpit for managing AI agent sessions across your git repos. Provider-agnostic: it works with Claude Code, Codex, and any CLI-based AI agent.

What is Abbado

Modern AI coding agents run in terminals, produce diffs, and need git workflows around them. Abbado gives you a single interface to launch agents, monitor their work in real time, review changes, and ship code — all from localhost:7777.

Instead of juggling terminal windows and manually tracking what each agent is doing, Abbado provides:

  • A unified dashboard showing all active sessions and their status
  • Real-time terminal views powered by WebSocket and xterm.js
  • Built-in diff viewer, commit, push, and PR creation
  • Provider-agnostic design — bring any CLI agent
  • Worktree isolation so multiple agents can work on the same repo simultaneously

Key Concepts

Projects

A project points to a local git repository. Each project has a mode:

  • Direct — the agent works directly in the repo. One session at a time.
  • Worktree — each session gets its own git worktree on an isolated branch. Run multiple agents in parallel on the same codebase without conflicts.

Agents

An agent is a reusable configuration that defines how to launch an AI coding tool. It includes:

  • Provider — the CLI tool to use (Claude Code, Codex, or any custom provider)
  • Model — which model the provider should use
  • Instructions — system-level instructions passed to the agent on every launch

You can create multiple agent configs and reuse them across projects and sessions.

Sessions

A session ties everything together: a project, an agent, and a branch. When you launch a session, Abbado:

  1. Creates a worktree (in worktree mode) or uses the repo directly
  2. Spawns the agent CLI in a PTY terminal with your configured instructions
  3. Installs hooks to track status in real time (working, idle, needs attention)
  4. Gives you a shell terminal alongside the agent
  5. Optionally attaches a reviewer agent for automated code review

Architecture Overview

Abbado is a single binary that runs locally. No cloud, no accounts, no telemetry.

  • Backend — Go with chi (HTTP router), gorilla/websocket, creack/pty for terminal management, and SQLite for persistence
  • Frontend — React 19 with Vite, shadcn/ui, TanStack Query, Tailwind CSS, xterm.js for terminals, and Monaco for diff viewing
  • Real-time — Server-Sent Events (SSE) for status updates, WebSocket for terminal I/O. No polling.
  • Storage — SQLite with WAL mode. Everything local, nothing leaves your machine.

Next Steps

Ready to get started?