AgentBell
3.0 · A trusted decision center

AgentBell

One Inbox for every automation decision that needs you.

Review trusted context for Claude Code permissions, Codex choices, and non-production release gates on iPhone, then distinguish approval from the actual execution result.

Join the TestFlightApproval guide ↓
AgentBellConnected
✓
Available modePermission requests will reach this device

Waiting for approval

PermissionRequest

Allow the test command to run?

claude-notify · now
npm run typecheck
DenyAllow

Recent activity

✓

Session filtering implemented and tested

Now
A trusted decision entry point, not a remote terminal

Understand first. Decide clearly. Approval is not success.

3.0 maps Claude, Codex, and Connector requests into one Inbox. Source, target, environment, risk, and deadline come first; Human response, Executor claim, and the final receipt stay distinct.

01Inbox

One unified Inbox

Claude, Codex, and Custom Connector decisions appear once, with clear Pending and History views.

02Review

Review trusted context

Source, target, environment, risk, deadline, and integrity details answer what approval means before you act.

03Decide

Bounded choices, fail closed

Confirm, choice, and bounded forms return only task input; timeout, conflict, and offline states never auto-allow.

04Receipt

See the actual outcome

The timeline separates Human response, Executor claim, execution, success, failure, and outcome unknown.

Ordinary Claude, running as usual

Three steps. No terminal on your phone.

  1. 01

    Pair

    Scan the QR code shown in your Mac terminal.

  2. 02

    Work

    Keep using the ordinary claude command, with no wrapper.

  3. 03

    Step away

    Important status and permission requests find you on iPhone.

Mac setup

Three steps for your developer automation

The installer connects official Claude Code hooks and can add the structured Codex decision skill. Keep using your existing commands after pairing, with no wrapper.

Decisions

When Claude asks a structured question, its options reach iPhone and your selection returns to the session.

Unified decisions

Tool permissions, structured choices, and non-production release gates enter the same Inbox with a clearly bound intent.

  1. 01

    Install the hooks

    Idempotently adds notification, status, decision, and permission hooks.

    bash <(curl -fsSL https://agentbell.app/install.sh)
  2. 02

    Pair your iPhone

    Scan the terminal QR in App Settings → Pair a new Mac.

    claude-notify-pair
  3. 03

    Switch to mobile mode

    Then use claude as usual. Requests reach your iPhone when needed.

    claude-notify-mode mobile

Timeouts, offline devices, and service errors never auto-allow; Claude Code falls back to the native Mac prompt.

3.0 · Human in the loop

Ask your iPhone before an agent crosses a decision point

AgentBell accepts bounded requests, records the Human response, and shows execution receipts. It does not start agents, perform target actions, or hold generic target credentials.

Claude Code permissions

After installation and switching to mobile mode, PermissionRequest events arrive automatically. Review the project, tool, and command summary, then allow or deny; no prompt changes are required.

Structured agent decisions

When an agent reaches a plan choice, continue/stop gate, or bounded option set, it explicitly invokes $claude-notify-decision. The result only selects the current task branch and never replaces system sandbox approval.

One-time setup

  1. 1

    Install

    Run the website installer; it adds both the decision CLI and Codex skill.

  2. 2

    Pair

    Run claude-notify-approval-pair, then verify and approve the Connector name, capabilities, and digest on iPhone.

  3. 3

    Tell your agent

    Paste the prompt below into the task. The agent will send a mobile decision and wait whenever your choice is needed.

Paste directly into your agentReady for skill-aware Codex. The same safety constraints apply to other agent integrations.
Connect this task to AgentBell mobile Approval:

1. Check that ~/bin/claude-notify-decision and ~/.codex/skills/claude-notify-decision/SKILL.md exist. If they are missing, run bash <(curl -fsSL https://agentbell.app/install.sh). Read that SKILL.md and follow its workflow when invoking $claude-notify-decision.
2. If the AgentBell Source credential is missing, run claude-notify-approval-pair, ask me to verify and approve the Connector on iPhone, and wait for pairing to finish.
3. Whenever this task reaches a bounded confirmation, single-choice, or multiple-choice decision that needs my input, use $claude-notify-decision to send it to my iPhone and wait for the authoritative response. Include only the minimum context required to decide. Never send secrets, credentials, full transcripts, source files, or sensitive data.
4. Continue a branch only after an explicit approved or selected response. Stop and explain the branch on denied or changes_requested. Never treat expired, cancelled, superseded, timeout, network failure, malformed output, or missing fields as consent.
5. AgentBell returns Human input for this task. It does not replace Codex sandbox/command approval or authorize external side effects.
Clear boundaries earn trust

Your session stays yours

AgentBell observes bounded status and returns explicit decisions. A timeout, offline device, or service problem never becomes an automatic allow; Claude Code falls back to the local Mac prompt.

It can

  • Send status and completion alerts
  • Show bounded session summaries
  • Handle approvals and option selection
  • Surface waiting state with Live Activities

It cannot

  • Start or take over Claude remotely
  • Mirror a terminal or upload full transcripts
  • Inject arbitrary prompts
  • Auto-allow on failure or timeout
AgentBell

Focus on the code. Your iPhone will tell you when it matters.

AgentBell 3.0 brings the decisions that matter in developer automation into one trusted Inbox.

Join the TestFlightGet on the App Store