agentio

AgentIO Claude Plugin

Agent notification system for Claude Code. Get notified via webhook when Claude needs input or completes tasks.

Installation

# Add the marketplace
claude plugin marketplace add https://github.com/dsc8x/agentio-claude-plugin

# Install the plugin
claude plugin install core@agentio

Start a new Claude Code session to activate the hooks and output styles.

Configuration

Set the webhook URL in your environment:

# In ~/.claude/.env
AGENTIO_EVENTS_WEBHOOK_URL=https://your-webhook-url/endpoint

What's Included

Hooks (auto-registered)

• UserPromptSubmit - Logs prompts, manages sessions, generates agent names
• PreToolUse (AskUserQuestion) - Notifies when Claude asks a question
• PermissionRequest - Notifies when Claude needs permission
• Stop - Notifies when Claude completes or needs input

Output Styles

• agentio - Sends task completion notifications via webhook

Webhook Payload

Notifications are sent as JSON POST requests:

{
  "event": "task_complete",
  "message": "Brief summary of what was done",
  "session_id": "abc123",
  "session_name": "SwiftRaven",
  "cwd": "/path/to/project",
  "timestamp": "2024-01-01T12:00:00Z",
  "hostname": "machine-name",
  "user": "username"
}

Event Types

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

Custom Status Line

Display agent name, model, and current prompt in Claude Code's status line.

Installation

# Create symlink to the status line script
ln -sf ~/.claude/plugins/marketplaces/agentio/scripts/statusline.py ~/.claude/statusline.py

# Make it executable
chmod +x ~/.claude/statusline.py

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "python3 ~/.claude/statusline.py",
    "padding": 0
  }
}

The symlink ensures you always get the latest version when the plugin updates.

What It Shows

[AgentName] | [Model] | 💡 Current prompt text...

• Agent Name - Generated session name (e.g., "SwiftRaven")
• Model - Current model (e.g., "Claude Sonnet 4")
• Prompt Icon - Context-aware icon based on prompt type:
  • ⚡ Slash commands
  • ❓ Questions
  • 💡 Create/build tasks
  • 🐛 Fix/debug tasks
  • ♻️ Refactor tasks
  • 💬 General prompts

Project Structure

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

License

MIT