agentio

AgentIO Claude Plugin

Webhook notifier for Claude Code. Sends a JSON POST to your endpoint when Claude finishes a turn, asks for input, requests permission, or invokes AskUserQuestion.

That's the entire scope. No state files. No log files. No name generator. No statusline. If you want a richer setup (auto-named sessions, statusline display, etc.) those concerns belong in your statusline / dashboard / external plugin — agentio reads CC's native data sources only.

Installation

claude plugin marketplace add https://github.com/dsc8x/agentio-claude-plugin
claude plugin install agentio@agentio

Start a new Claude Code session to activate the hooks.

Configuration

Set the webhook URL in your environment, or in ~/.claude/.env:

AGENTIO_EVENTS_WEBHOOK_URL=https://your-webhook-url/endpoint

Without it, agentio silently no-ops.

What's Included

Hooks (auto-registered)

Hook	When
PreToolUse(AskUserQuestion)	Claude is about to ask the user a question
PermissionRequest	Claude needs permission approval
Stop	Claude finished a turn — sends task_complete for substantive turns or needs_input if the message looks like a question

Output Style

agentio — instructs the model to call agentio-notify --event task_complete --message "<summary>" after substantive tasks. Activate with outputStyle: "agentio:agentio" in your settings.

Slash Commands

• /setup - Interactively configures AGENTIO_EVENTS_WEBHOOK_URL in ~/.claude/.env

Webhook Payload

{
  "event": "task_complete",
  "message": "Brief summary of what was done",
  "session_id": "abc123…",
  "session_name": "SwiftRaven",
  "cwd": "/path/to/project",
  "timestamp": "2026-04-28T20:30:00.000Z",
  "hostname": "machine-name",
  "user": "username"
}

Event	Description
task_complete	Claude finished a substantive task
needs_input	Claude is waiting for user input
ask_user	Claude invoked AskUserQuestion
permission_request	Claude needs permission approval

Where session_name comes from

Agentio doesn't generate names. The session_name field in webhook payloads is read from CC's session transcript, which records whatever you passed via claude --name X at session start:

claude --name "DeployFix"   # webhook payloads → "session_name": "DeployFix"
claude                       # webhook payloads → "session_name": ""

The name is stored as an agent-name event in ~/.claude/projects/<proj>/<session-id>.jsonl. Any tool — including custom statuslines, dashboards, or other plugins — can read it the same way.

If you'd like auto-generated names without manually passing --name, install the dsc8x plugin, which ships a deterministic AdjectiveAnimal-style namer (and a richer statusline).

CLI

# Direct mode (used by the agentio output style)
agentio-notify --event task_complete --message "Tests are passing"

# With explicit session metadata
agentio-notify --event task_complete --message "Done" \
    --session-id <uuid> --session-name "DeployFix"

# Hook mode (CC invokes this; payload arrives on stdin)
agentio-notify --handler stop
agentio-notify --handler permission_request
agentio-notify --handler ask_user

agentio-notify --version

Project Structure

agentio-claude-plugin/
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── commands/
│   └── setup.md
├── hooks/
│   └── hooks.json
├── scripts/
│   └── agentio-notify
├── styles/
│   └── agentio.md
└── README.md

License

MIT