Caddi
Sign inSign up

caddi listen

Caddi Auto is a small local daemon that watches your /requests inbox and hands tickets to your coding agent — usually Claude Code — to open PRs on dev.

install

bash
caddi listen install

# wrote ~/.caddi/auto/agent.toml
# wrote ~/.caddi/auto/runner.sh
# created LaunchAgent  com.caddi.auto (macOS)
# OR
# created systemd user unit  caddi-auto.service (Linux)

The installer asks where your agent binary lives (e.g. /usr/local/bin/claude) and which projects to enroll. Re-run any time to reconfigure.

start / stop / status

bash
caddi listen start
caddi listen status

# daemon:   running (pid 41212)
# agent:    claude (Claude Code 1.4.2)
# projects: meridian-studio · acme-marketing · planted
# queue:    0 in-flight, 2 today

caddi listen stop

How a request becomes a PR

  • The portal records a new pinpoint or request on a project you enrolled.
  • The daemon polls (or, on Pro, receives a webhook) and pulls the request payload — element selector, screenshot, reply thread, AGENTS.md.
  • It launches your agent inside a fresh worktree and feeds it a structured prompt.
  • If the agent finishes cleanly, the daemon opens a PR on dev.
  • If it errors or stalls, the daemon comments on the request and stops.
Caddi Auto never pushes to main or staging. It cannot merge PRs. It cannot edit env vars. The blast radius is bounded to one branch on one repo.

Pausing

bash
caddi listen pause meridian-studio
caddi listen resume meridian-studio

Or pause everything with caddi listen stop. The queue persists across restarts.

Next

Caddi Auto in depth →