Critters: An Automated Issue Processing Daemon Based on Claude Code

Introducing Critters—a TypeScript daemon that monitors Issues with specific tags in Linear or Jira, automatically runs Claude Code workflows, and enables end-to-end automation from planning and execution to review. It integrates AI programming tools with issue tracking systems, supports custom workflows and multiple deployment methods, focuses on operation and maintenance experience and security management, and represents the direction of end-to-end automation in AI-assisted software development.

The software engineering field has long faced efficiency bottlenecks such as issue backlogs and mismatched development resources. Stripe's open-source Minions project demonstrates the potential of AI agents to automatically handle development tasks. As an open-source implementation of this concept, Critters builds an automated workflow for autonomous planning, execution, and code review by integrating AI tools like Claude Code with issue tracking systems.

Critters adopts a daemon architecture, built on the Bun runtime, and manages multiple concurrent tasks via tmux panels. Bun ensures task processing efficiency, while tmux supports real-time monitoring of AI agent execution. The system supports Linear and Jira, detecting Issues with specific tags through polling and triggering predefined workflows.

The core abstraction is the Critter type, where each type defines configurable workflow stages (default includes planning, execution, review, and supports customization). Each stage corresponds to a Claude Code session, automatically passing context such as issue descriptions, repository status, and branches. The phased design decomposes complex tasks while retaining the flexibility for human intervention.

It provides a rich set of command-line tools covering initialization to daily operation and maintenance: the start command creates a tmux session to enter daemon mode; the status command displays an overview of active/queued tasks; the log command supports viewing details by stage or real-time stream; the prompt-render command previews prompt templates to help debug and optimize AI behavior, reducing deployment barriers.

Multiple deployment options are available: binary installation is suitable for quick trials; Docker Compose for containerized deployment with built-in dependencies like Claude Code CLI and GitHub CLI; supports custom Dockerfiles to extend language runtimes (e.g., Node.js, Bun, Python).

API keys (Anthropic, Linear/Jira authentication information) are injected via environment variables; Slack notifications support threaded pushes via Webhook URLs or Bot Tokens; documentation reminds users to manage sensitive configurations using .env files to avoid hardcoding keys into code or configurations.

Critters represents the direction of AI-assisted development moving from code completion to end-to-end task automation. AI agents take on repetitive, context-clear tasks, while humans focus on architectural design, complex decision-making, and innovation. With the advancement of multimodal large models, such automated workflows are expected to become the new normal in software engineering.