@saga-ai/cli 0.1.0
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 +76 -0
- package/dist/cli.cjs +3509 -0
- package/dist/cli.js +3063 -0
- package/package.json +47 -0
package/README.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# @saga-ai/cli
|
|
2
|
+
|
|
3
|
+
Command-line interface for SAGA (Structured Autonomous Goal Achievement) - a structured development workflow that combines human-guided epic planning with autonomous story execution.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @saga-ai/cli
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Requirements
|
|
12
|
+
|
|
13
|
+
- Node.js >= 18.0.0
|
|
14
|
+
- [Claude CLI](https://docs.anthropic.com/en/docs/claude-cli) (for `implement` command)
|
|
15
|
+
|
|
16
|
+
## Commands
|
|
17
|
+
|
|
18
|
+
### `saga init`
|
|
19
|
+
|
|
20
|
+
Initialize a new SAGA project structure.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
saga init
|
|
24
|
+
saga init --path /path/to/project
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Creates the `.saga/` directory structure:
|
|
28
|
+
- `.saga/epics/` - Epic definitions and stories
|
|
29
|
+
- `.saga/archive/` - Completed story archives
|
|
30
|
+
- `.saga/worktrees/` - Git worktrees for story isolation
|
|
31
|
+
|
|
32
|
+
Also updates `.gitignore` to ignore worktrees.
|
|
33
|
+
|
|
34
|
+
### `saga implement <story-slug>`
|
|
35
|
+
|
|
36
|
+
Run autonomous story implementation using Claude workers.
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
saga implement my-story
|
|
40
|
+
saga implement my-story --max-cycles 5
|
|
41
|
+
saga implement my-story --max-time 30
|
|
42
|
+
saga implement my-story --model sonnet
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Options:
|
|
46
|
+
- `--max-cycles <n>` - Maximum number of worker cycles (default: 10)
|
|
47
|
+
- `--max-time <n>` - Maximum time in minutes (default: 60)
|
|
48
|
+
- `--model <name>` - Model to use (default: opus)
|
|
49
|
+
|
|
50
|
+
**Note:** Requires `SAGA_PLUGIN_ROOT` environment variable to be set. This is automatically configured when running via the SAGA plugin.
|
|
51
|
+
|
|
52
|
+
### `saga dashboard`
|
|
53
|
+
|
|
54
|
+
Start the SAGA dashboard server for viewing epics, stories, and progress.
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
saga dashboard
|
|
58
|
+
saga dashboard --port 8080
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Options:
|
|
62
|
+
- `--port <n>` - Port to run the server on (default: 3847)
|
|
63
|
+
|
|
64
|
+
## Global Options
|
|
65
|
+
|
|
66
|
+
- `-p, --path <dir>` - Path to SAGA project directory (overrides auto-discovery)
|
|
67
|
+
- `-V, --version` - Output the version number
|
|
68
|
+
- `-h, --help` - Display help for command
|
|
69
|
+
|
|
70
|
+
## Project Discovery
|
|
71
|
+
|
|
72
|
+
The CLI automatically discovers SAGA projects by looking for a `.saga/` directory in the current directory or any parent directory. Use `--path` to override this behavior.
|
|
73
|
+
|
|
74
|
+
## License
|
|
75
|
+
|
|
76
|
+
MIT
|