herdctl 0.3.0 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +95 -0
- package/package.json +3 -3
package/README.md
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# herdctl
|
|
2
|
+
|
|
3
|
+
> Autonomous Agent Fleet Management for Claude Code
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/herdctl)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
|
|
8
|
+
**Documentation**: [herdctl.dev](https://herdctl.dev)
|
|
9
|
+
|
|
10
|
+
## Overview
|
|
11
|
+
|
|
12
|
+
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.
|
|
13
|
+
|
|
14
|
+
Think of it as "Kubernetes for AI agents" - declarative configuration, pluggable integrations, and continuous operation.
|
|
15
|
+
|
|
16
|
+
## Installation
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm install -g herdctl
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Quick Start
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
# Initialize a new project
|
|
26
|
+
herdctl init
|
|
27
|
+
|
|
28
|
+
# Start your agent fleet
|
|
29
|
+
herdctl start
|
|
30
|
+
|
|
31
|
+
# Check fleet status
|
|
32
|
+
herdctl status
|
|
33
|
+
|
|
34
|
+
# Manually trigger an agent
|
|
35
|
+
herdctl trigger my-agent
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Configuration
|
|
39
|
+
|
|
40
|
+
Create a `herdctl.yaml` in your project root:
|
|
41
|
+
|
|
42
|
+
```yaml
|
|
43
|
+
fleet:
|
|
44
|
+
name: my-fleet
|
|
45
|
+
|
|
46
|
+
agents:
|
|
47
|
+
- path: ./agents/my-agent.yaml
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Then define your agent in `agents/my-agent.yaml`:
|
|
51
|
+
|
|
52
|
+
```yaml
|
|
53
|
+
name: my-agent
|
|
54
|
+
model: claude-sonnet-4-20250514
|
|
55
|
+
|
|
56
|
+
schedules:
|
|
57
|
+
daily-review:
|
|
58
|
+
type: cron
|
|
59
|
+
cron: "0 9 * * *"
|
|
60
|
+
prompt: "Review open PRs and provide feedback"
|
|
61
|
+
|
|
62
|
+
permissions:
|
|
63
|
+
mode: bypassPermissions
|
|
64
|
+
allowed_tools:
|
|
65
|
+
- Read
|
|
66
|
+
- Glob
|
|
67
|
+
- Grep
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Features
|
|
71
|
+
|
|
72
|
+
- **Fleet Management** - Run multiple Claude Code agents with a single command
|
|
73
|
+
- **Declarative Config** - Define agents, schedules, and permissions in YAML
|
|
74
|
+
- **Multiple Triggers** - Interval, cron, webhooks, chat messages
|
|
75
|
+
- **Work Sources** - GitHub Issues integration (Jira/Linear planned)
|
|
76
|
+
- **Execution Hooks** - Shell commands, webhooks, Discord notifications
|
|
77
|
+
- **Chat Integration** - Discord connector for conversational agents
|
|
78
|
+
|
|
79
|
+
## Documentation
|
|
80
|
+
|
|
81
|
+
For complete documentation, visit [herdctl.dev](https://herdctl.dev):
|
|
82
|
+
|
|
83
|
+
- [Getting Started](https://herdctl.dev/getting-started/installation/)
|
|
84
|
+
- [Configuration Reference](https://herdctl.dev/configuration/fleet/)
|
|
85
|
+
- [CLI Reference](https://herdctl.dev/cli-reference/commands/)
|
|
86
|
+
- [Guides](https://herdctl.dev/guides/github-issues/)
|
|
87
|
+
|
|
88
|
+
## Related Packages
|
|
89
|
+
|
|
90
|
+
- [`@herdctl/core`](https://www.npmjs.com/package/@herdctl/core) - Core library for programmatic fleet management
|
|
91
|
+
- [`@herdctl/discord`](https://www.npmjs.com/package/@herdctl/discord) - Discord connector for chat-based agents
|
|
92
|
+
|
|
93
|
+
## License
|
|
94
|
+
|
|
95
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "herdctl",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"description": "Autonomous Agent Fleet Management for Claude Code",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -16,8 +16,8 @@
|
|
|
16
16
|
"dependencies": {
|
|
17
17
|
"@inquirer/prompts": "^8.2.0",
|
|
18
18
|
"commander": "^12",
|
|
19
|
-
"@herdctl/core": "
|
|
20
|
-
"@herdctl/discord": "0.
|
|
19
|
+
"@herdctl/core": "1.1.0",
|
|
20
|
+
"@herdctl/discord": "0.1.1"
|
|
21
21
|
},
|
|
22
22
|
"devDependencies": {
|
|
23
23
|
"typescript": "^5",
|