Agent Share

Overview

agent-share is the standalone Go CLI for the Agent Share bridge — a direct, bidirectional line between your phone (the PWA at share.agentics.dk) and the coding agents running in your repos.

• Phone → agent: screenshots, links, decisions, live iPhone screen, and webhook events.
• Agent → phone: questions and previews delivered via Web Push.

What you get

• A pull-based agent inbox. The shipped product is an inbox the agent checks on a hosted MCP server. It works in any MCP client (Claude Code, Cline, Cursor) — no flags, no research-preview dependency.
• Optional Claude Code channels push (research preview). A separate Claude-Code-only mechanism that pushes content into a running session as a <channel> tag. See Channels & the agent inbox.
• A phone PWA at share.agentics.dk — the browser inbox/viewer for shares, event cards, and live stream tiles.
• Live iPhone screen-mirror into the inbox (shipped 1.17.0): AirPlay your iPhone to the agent-share airplay receiver and the PWA plays it over WebRTC/WHEP.
• Inbound webhooks (Coolify/CI) that land as kind=event shares with facets like provider, severity, and status.

How it fits together

Your phone/PWA and external systems write shares into an inbox on share.agentics.dk. Your agent connects to that inbox over MCP (bearer token, no central account beyond OIDC login), reads and acknowledges items, and pushes replies back to your phone. Reading is deliberately separate from acknowledging — the agent controls when an item leaves the new view.

Two transports at a glance:

• Shipped — a pull inbox. The agent checks for new shares when you point it at your phone; it isn't interrupted by incoming items.
• Research preview — channels. In Claude Code, shares push into a live session on their own. See the Channels page.

Subcommands

login · init · register · agents (list, ls) · disable · enable · mcp · channel · card · install · airplay · webhook (webhooks) · version · help

See the CLI reference for every flag and the full env-var table.

Next steps

• Quickstart — install, sign in, wire your first inbox.
• Use it with Claude Code — init vs register vs install.
• Channels & the agent inbox — read-state model, pull vs push.
• CLI reference — subcommands, flags, env vars.
• MCP tools reference — share.* and stdio tool catalogs.

Defaults

Setting	Value
Server	https://share.agentics.dk
OIDC issuer	https://login.agentics.dk/realms/agentics
Client id	agentics-share-desktop
Config dir	~/.agent-share

Override with AGENT_SHARE_SERVER, AGENT_SHARE_ISSUER, AGENT_SHARE_CLIENT_ID, and AGENT_SHARE_HOME. See the CLI reference for the full env-var table.