@supaku/agentfactory-cli 0.4.1 → 0.4.3
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 +90 -0
- package/package.json +4 -4
package/README.md
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# @supaku/agentfactory-cli
|
|
2
|
+
|
|
3
|
+
CLI tools for [AgentFactory](https://github.com/supaku/agentfactory). Run a local orchestrator, remote workers, worker fleets, and queue management.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Global (CLI commands)
|
|
9
|
+
npm install -g @supaku/agentfactory-cli
|
|
10
|
+
|
|
11
|
+
# Local (programmatic runner functions)
|
|
12
|
+
npm install @supaku/agentfactory-cli
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## CLI Commands
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
# Spawn agents on backlog issues
|
|
19
|
+
af-orchestrator --project MyProject --max 3
|
|
20
|
+
|
|
21
|
+
# Process a single issue
|
|
22
|
+
af-orchestrator --single PROJ-123
|
|
23
|
+
|
|
24
|
+
# Dry run — preview what would be processed
|
|
25
|
+
af-orchestrator --project MyProject --dry-run
|
|
26
|
+
|
|
27
|
+
# Start a remote worker
|
|
28
|
+
af-worker --api-url https://your-app.vercel.app --api-key your-key
|
|
29
|
+
|
|
30
|
+
# Start a worker fleet (auto-detects CPU cores)
|
|
31
|
+
af-worker-fleet --api-url https://your-app.vercel.app --api-key your-key
|
|
32
|
+
|
|
33
|
+
# Clean up orphaned git worktrees
|
|
34
|
+
af-cleanup
|
|
35
|
+
|
|
36
|
+
# Queue management
|
|
37
|
+
af-queue-admin list
|
|
38
|
+
af-queue-admin drain
|
|
39
|
+
|
|
40
|
+
# Analyze agent session logs
|
|
41
|
+
af-analyze-logs --follow
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Programmatic Usage
|
|
45
|
+
|
|
46
|
+
All CLI tools are available as importable functions via subpath exports:
|
|
47
|
+
|
|
48
|
+
```typescript
|
|
49
|
+
import { runOrchestrator } from '@supaku/agentfactory-cli/orchestrator'
|
|
50
|
+
|
|
51
|
+
await runOrchestrator({
|
|
52
|
+
project: 'MyProject',
|
|
53
|
+
max: 3,
|
|
54
|
+
dryRun: false,
|
|
55
|
+
})
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Available Runner Functions
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
import { runOrchestrator } from '@supaku/agentfactory-cli/orchestrator'
|
|
62
|
+
import { runWorker } from '@supaku/agentfactory-cli/worker'
|
|
63
|
+
import { runWorkerFleet } from '@supaku/agentfactory-cli/worker-fleet'
|
|
64
|
+
import { runCleanup } from '@supaku/agentfactory-cli/cleanup'
|
|
65
|
+
import { runQueueAdmin } from '@supaku/agentfactory-cli/queue-admin'
|
|
66
|
+
import { runLogAnalyzer } from '@supaku/agentfactory-cli/analyze-logs'
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Each function accepts a config object and returns a Promise — use them to build thin wrappers with your own env loading and argument parsing.
|
|
70
|
+
|
|
71
|
+
## Environment Variables
|
|
72
|
+
|
|
73
|
+
| Variable | Used By | Description |
|
|
74
|
+
|----------|---------|-------------|
|
|
75
|
+
| `LINEAR_API_KEY` | orchestrator | Linear API key |
|
|
76
|
+
| `WORKER_API_URL` | worker, fleet | Webhook server URL |
|
|
77
|
+
| `WORKER_API_KEY` | worker, fleet | API key for authentication |
|
|
78
|
+
| `REDIS_URL` | queue-admin | Redis connection URL |
|
|
79
|
+
|
|
80
|
+
## Related Packages
|
|
81
|
+
|
|
82
|
+
| Package | Description |
|
|
83
|
+
|---------|-------------|
|
|
84
|
+
| [@supaku/agentfactory](https://www.npmjs.com/package/@supaku/agentfactory) | Core orchestrator |
|
|
85
|
+
| [@supaku/agentfactory-server](https://www.npmjs.com/package/@supaku/agentfactory-server) | Redis work queue |
|
|
86
|
+
| [@supaku/agentfactory-nextjs](https://www.npmjs.com/package/@supaku/agentfactory-nextjs) | Next.js webhook server |
|
|
87
|
+
|
|
88
|
+
## License
|
|
89
|
+
|
|
90
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@supaku/agentfactory-cli",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.3",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "CLI tools for AgentFactory — local orchestrator, remote worker, queue admin",
|
|
6
6
|
"author": "Supaku (https://supaku.com)",
|
|
@@ -76,9 +76,9 @@
|
|
|
76
76
|
],
|
|
77
77
|
"dependencies": {
|
|
78
78
|
"dotenv": "^17.2.3",
|
|
79
|
-
"@supaku/agentfactory-
|
|
80
|
-
"@supaku/agentfactory-
|
|
81
|
-
"@supaku/agentfactory": "0.4.
|
|
79
|
+
"@supaku/agentfactory-linear": "0.4.3",
|
|
80
|
+
"@supaku/agentfactory-server": "0.4.3",
|
|
81
|
+
"@supaku/agentfactory": "0.4.3"
|
|
82
82
|
},
|
|
83
83
|
"devDependencies": {
|
|
84
84
|
"@types/node": "^22.5.4",
|