# handup

> Approval queue for AI agents: rich previews, fast decisions, any agent. It snapshots previews and records decisions; it never executes proposed actions.

Every page below is plain Markdown. The complete documentation in one file is at https://docs.gethandup.dev/llms-full.txt.

## Docs

- [Approval queue for AI agents](https://docs.gethandup.dev/index.md): Approval queue for AI agents. Agents ask, a human approves or denies from the terminal, desktop or phone, and the agent gets the decision back.
- [Claude Code](https://docs.gethandup.dev/agents/claude-code.md): The installer merges a PermissionRequest command hook (handup hook claude, timeout 660 seconds) into ~/.claude/settings.json and the handup MCP server into ~/.claude.json (below); --no-mcp installs…
- [Codex](https://docs.gethandup.dev/agents/codex.md): The reversible installer merges handup hook codex into $CODEX_HOME/hooks.json (default ~/.codex/hooks.json) and the handup MCP server into $CODEX_HOME/config.toml (below); --no-mcp installs only th…
- [cursor](https://docs.gethandup.dev/agents/cursor.md): The installer safely merges the handup stdio server (command handup, args ["mcp"]) into ~/.cursor/mcp.json, backing up before changes.
- [Any agent or custom harness](https://docs.gethandup.dev/agents/custom.md): Use this guide to add handup to an agent or harness without a dedicated adapter (your own agent loop, an SDK app, a framework, a CI job).
- [Email drafts](https://docs.gethandup.dev/agents/email.md): Sending email is external publication: ask before every send.
- [MCP stdio](https://docs.gethandup.dev/agents/mcp.md): Run handup mcp in the project directory.
- [omp](https://docs.gethandup.dev/agents/omp.md): Then run /mcp reload in omp (or restart it).
- [Shell and CI](https://docs.gethandup.dev/agents/shell-ci.md): Ask before destructive/irreversible actions, external publication or messages, costly resource use, credential changes/access, or ambiguous intent.
- [Give your agent the handup workflow](https://docs.gethandup.dev/agents/skill.md): Agents need the approval contract and usage instructions, not the handup application source.
- [Per-request callbacks](https://docs.gethandup.dev/integrations/callbacks.md): Use a callback when the submitting system cannot keep a connection open.
- [Event hooks](https://docs.gethandup.dev/integrations/hooks.md): Use top-level hooks: in config.yaml to send request lifecycle events to any HTTP receiver or local program.
- [Integrations](https://docs.gethandup.dev/integrations/index.md): Integrations connect handup to tools other than the agent that asks for approval, so they can react as requests are created and decided.
- [Integration submission tokens](https://docs.gethandup.dev/integrations/tokens.md): A named submit token lets CI, n8n, Home Assistant, or a remote script submit a request and wait for a human.
- [Remote access](https://docs.gethandup.dev/remote.md): Approve requests from a phone or another computer.
- [End-to-end encrypted relay](https://docs.gethandup.dev/relay.md): Use handup-relay when your phone is not on your tailnet.
- [Mobile app](https://docs.gethandup.dev/mobile.md): The handup mobile app is a companion to the daemon on your computer, not a daemon of its own.
- [Desktop app](https://docs.gethandup.dev/desktop.md): The desktop app is a window onto the same local queue that handup ls shows.
- [Rules, scoped allow, presence, and terminal inbox](https://docs.gethandup.dev/rules.md): Rules live beside the selected config file: ~/.config/handup/rules.yaml on Linux by default.
- [CLI and daemon reference](https://docs.gethandup.dev/cli.md): Request limits, exit codes, timeouts, storage paths, the daemon API, and notification and configuration details.
- [Downloads and installation](https://docs.gethandup.dev/downloads.md): handup ships as compiled binaries and packages from its public release host, github.com/gethandup/handup.

## Machine contracts

- [OpenAPI](https://docs.gethandup.dev/openapi.json): daemon HTTP API
- [Request schema](https://docs.gethandup.dev/schema/request.schema.json): JSON Schema
- [Decision schema](https://docs.gethandup.dev/schema/decision.schema.json): JSON Schema