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)