handup

Approval queue for AI agents. Rich previews, fast decisions, any agent. Review and decide anywhere, or run command requests in the desktop app and return the result to your agent.

Set up an agent MCP reference

handup is pre-alpha. Agents submit a request with previews (a command, diff, file, image, JSON and more), wait, and receive the human decision with the content hash they must bind execution to. A deny is a normal answer with feedback, never a transport error and never permission to retry unchanged.

Command requests can also be run explicitly from the desktop app with Run or Run as admin. The agent receives run_result and must not run the command again. Phone and web clients only review and decide; see Desktop.

Install

Install compiled handup software from downloads and releases. You do not need Git, Rust, Make or application source access. No public release has been published yet; platform availability is listed in the downloads guide.

After installing a supported release:

handup service install  # run the daemon as a user service
handup doctor --json

Set up an agent in 60 seconds

handup integrate mcp --client claude-code  # also codex, cursor, omp
handup prompt --agent claude              # paste into your project instructions
handup ask --title "Review action" --command "echo hello" --wait --json

Decide from another terminal with handup approve ID or handup deny ID -m "feedback", from the desktop inbox (handup ui), or from a paired phone. Every flag is described by handup help COMMAND.

Where to go next

Agents: Claude Code, Codex, cursor, omp, MCP and shell/CI setup, with the approval contract agents must follow.
Any agent or custom harness: steps to add handup to your own agent loop, SDK app or framework over MCP, CLI or HTTP.
Email drafts: ask before sending, let the human edit the draft, then send it with your own mail tool.
Agent skill: print instructions with the installed CLI or run npx skills add gethandup/handup for complete offline docs.
Integrations: let other tools react to requests.
Remote access, the relay, the mobile app and the desktop app: approve away from the terminal.
Rules: scoped allow rules, presence routing and the terminal inbox.
Machine contracts: the daemon OpenAPI and the request and decision JSON Schemas.

Agents can read these docs as plain Markdown: /llms.txt indexes every page and /llms-full.txt is the whole set in one file.

Support

Email support@gethandup.dev. The product site is gethandup.dev.