CLI Reference
The abbado command manages the Abbado server. Run it in the foreground for development, or as a background daemon for day-to-day use.
Commands
abbado
Start the server in the foreground. Logs are printed to stdout. Press Ctrl+C to stop.
abbado abbado start
Start the server as a background daemon. The process ID is written to ~/.abbado/abbado.pid and logs are written to ~/.abbado/abbado.log.
abbado start abbado stop
Stop the background daemon. Sends SIGTERM to the process and removes the PID file.
abbado stop abbado status
Show whether the server is running, its PID, and the URL it is listening on.
abbado status
# Example output:
# Abbado is running (PID 12345)
# URL: http://localhost:7777 abbado logs
Tail the last 50 lines of the log file and follow new output. Use --no-follow for a static snapshot.
# Follow logs in real time
abbado logs
# Print last 50 lines and exit
abbado logs --no-follow abbado version
Print the version string. The version is set at build time.
abbado version
# Example output:
# abbado v0.3.0 (abc1234) Environment Variables
| Variable | Default | Description |
|---|---|---|
ABBADO_PORT | 7777 | Port the HTTP server listens on |
ABBADO_DB | ~/.abbado/abbado.db | Path to the SQLite database file |
Data Directory
Abbado stores all its data in ~/.abbado/. This directory is created automatically on first run.
| File / Directory | Purpose |
|---|---|
abbado.db | SQLite database (agents, projects, sessions, events) |
abbado.pid | PID file for the background daemon |
abbado.log | Log file for the background daemon |
worktrees/ | Git worktrees created for worktree-mode sessions |
hooks/ | Generated hook configurations (settings.json per session) |