v1.6.0Available for macOS and Linux

Stop checking
every terminal.

Agent Inbox collects questions, approvals, plans, and status updates from coding agents. Answer in one place instead of hunting through your sessions.

Free and open source.

Try answering a sample request.

Agent Inbox / All projects Sample data

Needs you

3 open requests across your projects

All requests
customer-portalDecision

Which sign-in approach should I use?

The portal is ready for authentication. Using your existing provider keeps accounts in one place.

Why this needs you

This choice determines how customers access the portal. After your decision, the agent will wire up sign-in and add the integration tests.

GitHub Copilot CLI Claude Code Built on MCP

Built around the work
agents leave behind.

Agent Inbox turns scattered terminal interruptions into a shared, durable workflow for the decisions only you can make.

389requests captured
145plans tracked
1,008plan rows kept with their outcomes
62–77%smaller agent-read payload estimates in internal scenarios

Based on maintainer usage.

One queue across projects.

Bring decisions and human tasks out of individual agent sessions.

Context at the decision point.

Keep the action, tradeoffs, background, and next step together.

From request to outcome.

See what waits on you, what the agent picked up, and what finished.

Durable plans.

Keep progress, responses, and outcomes attached to stable work.

Answer without
switching terminals.

Open a request to see the project and what needs your attention. Respond there, with the background close by.

Questions with enough context.

Each question includes the decision and why it matters. Choose an option, write your own answer, ask for clarification, or snooze it. Open approvals can also show a Preview link for the current PR head when your project publishes successful, non-production GitHub deployment metadata.

Try a sample question

Keep decisions with their plans.

Plans keep tasks, responses, and recorded outcomes together, so you can see what happened on each project. An agent can link a plan to a GitHub issue. The plan then lists the issue's sub-issues and how many are done, and rows linked to a sub-issue show their parent. Agent Inbox looks these up through your signed-in GitHub CLI.

Waiting on youWith agentsOutcome

See what each agent reports.

Check the latest status from connected sessions. Background refreshes keep the inbox current without pulling keyboard focus away from chat or another app; in the active viewer, keyboard focus stays where you left it. Working, waiting, and idle are separate states.

Copilot CLIRunning checkout tests
Claude CodeUpdating the docs
Copilot CLIIdle

How it works

Agents send requests through MCP. You answer in Agent Inbox, and they read your response through the same connection.

Connected through MCP
  1. An agent asks for input.

    It sends the question and background to Agent Inbox, along with the project it belongs to.

  2. You respond in Agent Inbox.

    Pick an option, write your own answer, or mark a task done. You can also ask for clarification or snooze the request.

  3. The agent reads your reply.

    Your agent checks MCP for responses. You'll see when it has picked up your answer and when it records an outcome.

Your inbox lives
on your machine.

Questions, plans, and responses are stored in a local SQLite database. Agent Inbox doesn't call a model or run a hosted service.

No telemetryMIT licensed

Get Agent Inbox

Start with the desktop app, or run it from a Node.js checkout.

Desktop app

After installing, open Settings → Setup and choose your coding tools. Start a fresh CLI session to load the connection.

In the macOS app and the Linux AppImage, Settings → Updates can download a new release, check it against the signed release manifest, and install it when you choose Install and restart. Setup's Update agents button then moves your agents to the new version.

Get the desktop app Installation guide macOS 13.5+ · Linux x64 & arm64

Run from source

Use Node.js 24. These commands build the app and preview the agent setup.

Terminal
git clone https://github.com/shariqh/agent-inbox.git
cd agent-inbox
npm ci
npm run build
npm run install:agents
The final command previews MCP and instruction changes.
Read the full setup guide

Common questions

Read the documentation
Is this another coding agent?

No. It stores the questions, plans, and updates your coding agents send, along with your replies. It doesn't write code or make model calls.

Which coding tools does it work with?

Any app that can connect to a stdio MCP server can use Agent Inbox. The installer automates setup for GitHub Copilot CLI and Claude Code; other MCP clients need manual configuration.

Does my inbox leave my machine?

Your inbox is stored locally, with no Agent Inbox telemetry or hosted service. Optional update checks and downloads contact GitHub, and so do pull request and issue lookups when the GitHub CLI is installed and signed in. Your coding tools still have their own data and model policies.

When does an approval show a Preview link?

Agent Inbox shows Preview only on an open approval question or blocked approval plan row when GitHub reports a successful, explicitly non-production deployment for the current PR head. Your project must publish standard GitHub deployment metadata. Missing, stale, or conflicting records leave the Preview link out; the approval controls stay available.

How does an agent receive my answer?

Agents read replies through the MCP pending tool. Copilot CLI can use background watchers for questions and blocked plan actions; Claude Code has opt-in wake-up hooks. Wake-up depends on your setup. The receipt shows whether the agent has picked up your answer. On a Copilot CLI request, choose "I'll take a while" to tell the agent to stop waiting, or to wait quietly for a few hours or until tomorrow. If it stops, message it after you answer. The request stays in your inbox.

Where can I run Agent Inbox?

Desktop packages are available for macOS 13.5+ on Apple silicon and Intel, and Linux on x64 and arm64. You can also run the local browser viewer from a Node.js 24 checkout. See the installation guide for Linux runtime requirements and package verification. Windows and hosted deployments are not currently supported.