The Vision

Claude Code has changed the world, but most of the work it does is supervised by a human. What if Claude Code could invoke itself?

herdctl is an orchestration layer for Claude Code. Under the hood, it uses the Claude Agents SDK to trigger Claude Code sessions on schedules, via webhooks, or via chat messages.

It uses simple .yml files that are a thin wrapper around Claude Agents SDK configs, plus a couple of extra features provided by herdctl - schedules, chat and hooks. Each Agent defined this way can have any number of schedules that trigger the agent to do something automatically.

herdctl can run fleets of agents, each with their own source-controllable configurations. Agent fleets can be run anywhere via a simple herdctl start command.

herdctl allows you to interact with all of your existing Claude Code projects via chat apps like Discord and Slack (Telegram support coming soon).

Key Features

• Self-Invoking Agents — Define agents that wake themselves up on schedules or triggers. Coordinate an entire fleet from a single herdctl start command.

• Fleet Composition — Build "super-fleets" from multiple project fleets. Each project keeps its own agent configurations, but they all run together with a unified web dashboard and CLI.

• Full Claude Code Power — If Claude Code can do it, your herdctl agent can do it. Same tools, same MCP servers, same capabilities. herdctl is a thin orchestration layer, not a sandbox.

• Two Runtimes — CLI runtime uses your Claude Max subscription (much cheaper per token). SDK runtime uses API pricing. Both support Docker isolation with resource limits and network controls.

• Chat From Anywhere — Connect agents to Discord or Slack. Message your agents from your phone, get responses, and they continue working based on your conversation. Your PR reviewer bot becomes a team member you can @ mention.

• Session Continuity — Every job creates a real Claude SDK session. When an agent finishes, you can claude --resume that exact session in your terminal. Pick up where the agent left off with full context intact.

• Bidirectional Communication — Agents write structured data back to herdctl via metadata files. Hooks act on that data. Coming soon: agents that request schedule changes, store persistent context, and evolve their own behavior over time.

Intro Video

In which we try to cover all of the main parts of herdctl in 20 minutes:

Quick Start

# Install herdctl globally
npm install -g herdctl

# Initialize a new project with example agents
herdctl init

# Start your agent fleet
herdctl start

Your agents are now running. Check their status:

herdctl status

Web Dashboard

The web dashboard gives you a browser-based control panel for your fleet. Enable it with herdctl start --web or web.enabled: true in your config.

• Fleet overview — real-time status of all agents and recent jobs
• Agent detail — live output streaming, schedule controls, job history
• Interactive chat — message any agent directly from the browser
• Schedule management — trigger, enable, and disable schedules
• Job management — cancel, fork, and inspect jobs

See the web dashboard documentation for full details.

Packages

| Package | Description | |---------|-------------| | herdctl | CLI for fleet management. Install globally, run herdctl start. | | @herdctl/core | Core library. Embed fleet management in your own applications. | | @herdctl/web | Web dashboard. Real-time fleet monitoring, agent chat, and job management in your browser. | | @herdctl/discord | Discord connector. Chat with your agents via Discord DMs and channels. | | @herdctl/slack | Slack connector. Chat with your agents via Slack channels and DMs. | | @herdctl/chat | Shared chat infrastructure. Session management, streaming, and message handling used by all connectors. |

Documentation

Full documentation at herdctl.dev:

• Getting Started
• Configuration Reference
• CLI Reference
• Library Reference
• Guides & Recipes

Contributing

Contributions welcome! See CONTRIBUTING.md for development setup and guidelines.

Community

• Discord - Chat with the community
• GitHub Discussions - Ask questions, share ideas
• Developer Blog - Articles and deep dives
• Twitter/X - Updates and announcements

License

MIT License - see LICENSE for details.