brainiac-fizzy

Fizzy card management plugin for Brainiac.

Handles the full Fizzy integration: card assignment, comment routing, @mentions, cross-agent reviews, duplicate detection, deploy shortcuts, and deployment environment tracking.

brainiac install fizzy
brainiac restart

Or manually:

gem install brainiac-fizzy

Then add to ~/.brainiac/plugins.json:

{
  "plugins": [
    { "name": "fizzy", "gem": "brainiac-fizzy" }
  ]
}

Fizzy configuration lives in ~/.brainiac/fizzy.json (same as before):

{
  "authorized_users": [
    { "id": "user-id-1", "name": "Andy", "human": true },
    { "id": "agent-id-1", "name": "Galen", "human": false }
  ],
  "boards": {
    "development": {
      "board_id": "your-board-id",
      "webhook_secret": "secret-for-this-board",
      "columns": {
        "right_now": "column-id",
        "needs_review": "column-id",
        "uat": "column-id"
      }
    }
  }
}

Set your Fizzy webhook URL to:

https://your-ngrok.ngrok-free.app/fizzy/development

Where development is the board key from fizzy.json. Set the secret to the board's webhook_secret.

This plugin runs inside the brainiac server process and uses core functions:

• verify_signature! — webhook HMAC verification
• run_agent — agent CLI dispatch
• session_active?, already_processed? — deduplication
• identify_project_by_tags — card-to-project mapping
• create_or_reuse_worktree — git worktree management
• prefetch_card_context — card body/comments pre-fetch
• render_prompt — prompt template composition
• reload_projects!, reload_agent_registry! — config hot-reload

These are all provided by the brainiac gem (runtime dependency).

If upgrading from brainiac's built-in Fizzy handler:

1. Install the plugin: brainiac install fizzy
2. Disable the built-in handler in ~/.brainiac/brainiac.json:

   { "handlers": { "fizzy": false } }

3. Restart: brainiac restart

The plugin uses the exact same config files and functions — it's a drop-in replacement.

cd ~/Code/brainiac-fizzy
bundle install
rake test

MIT