Autonomous Agent Fleet Management for Claude Code
npm install herdctl> Autonomous Agent Fleet Management for Claude Code


Documentation: herdctl.dev
Herdctl is an open-source CLI for running fleets of autonomous AI agents powered by Claude Code. Define your agents in YAML, configure schedules and triggers, and let them work autonomously on your codebase.
Think of it as "Kubernetes for AI agents" - declarative configuration, pluggable integrations, and continuous operation.
``bash`
npm install -g herdctl
`bashInitialize a new project
herdctl init
Configuration
Create a
herdctl.yaml in your project root:`yaml
fleet:
name: my-fleetagents:
- path: ./agents/my-agent.yaml
`Then define your agent in
agents/my-agent.yaml:`yaml
name: my-agent
model: claude-sonnet-4-20250514schedules:
daily-review:
type: cron
cron: "0 9 *"
prompt: "Review open PRs and provide feedback"
permission_mode: bypassPermissions
allowed_tools:
- Read
- Glob
- Grep
`Features
- Fleet Management - Run multiple Claude Code agents with a single command
- Declarative Config - Define agents, schedules, and permissions in YAML
- Multiple Triggers - Interval, cron, webhooks, chat messages
- Work Sources - GitHub Issues integration (Jira/Linear planned)
- Execution Hooks - Shell commands, webhooks, Discord notifications
- Chat Integration - Discord connector for conversational agents
- Session Management - List and resume Claude Code sessions from CLI
Documentation
For complete documentation, visit herdctl.dev:
- Getting Started
- Configuration Reference
- CLI Reference
- Guides
Related Packages
@herdctl/core - Core library for programmatic fleet management
- @herdctl/discord` - Discord connector for chat-based agentsMIT