ferrix

Automated bug-fixing system powered by Claude

Ferrix polls Linear for assigned tickets, uses Claude to generate fixes, and creates pull requests via GitHub — all running as a background daemon with a terminal UI.

Documentation

Features

• Linear integration — automatically picks up assigned tickets
• AI-powered fixes — Claude implements changes, self-reviews, and summarizes
• PR lifecycle — creates PRs, addresses review comments, resolves threads
• External PR monitoring — scans your non-ferrix PRs for review requests
• Terminal UI — dashboard, logs, repo management, ticket tracking
• Background daemon — runs detached with IPC communication

Install

brew install akparhi/tap/ferrix

Usage

$ ferrix          Launch TUI (auto-starts daemon)
$ ferrix start    Start daemon in background
$ ferrix stop     Stop daemon
$ ferrix status   Show daemon status
$ ferrix logs     Tail daemon logs

Prerequisites

• Claude CLI or Codex CLI — at least one AI agent must be available
• gh — GitHub CLI for PR creation
• Linear API key — entered during first-run setup wizard

License

MIT