Agent integrations

Built-in integrations

Agent	Integration	Install
Pi	Extension	agent-beacon integrate install pi
OpenCode	Plugin	agent-beacon integrate install opencode
DeepSeek Harness	Cordis plugin	agent-beacon integrate install dsh
Claude Code	Hooks	Use the Claude Code hooks configuration in the repository
Other agents	CLI / HTTP	agent-beacon report or POST /api/v1/events

Built-in integrations ship with the local service and can be installed or upgraded from the CLI.

Status model

AgentBeacon tracks four session states:

• idle
• working
• waiting
• error

Multiple session states are aggregated into one current state, which is mapped to a light effect. The mapping is editable in the console.

Other agents

For agents without a built-in integration, report state changes with:

agent-beacon report

Or send an event to the local POST /api/v1/events endpoint. See agent-beacon report --help for CLI flags. All requests stay on 127.0.0.1; no cloud account is involved.