@saga-ai/cli 0.1.4 → 0.3.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.
Files changed (3) hide show
  1. package/README.md +39 -0
  2. package/dist/cli.cjs +1699 -50
  3. package/package.json +3 -2
package/README.md CHANGED
@@ -13,6 +13,8 @@ Run commands using npx (no global installation required):
13
13
 
14
14
  ```bash
15
15
  npx @saga-ai/cli init
16
+ npx @saga-ai/cli find <query>
17
+ npx @saga-ai/cli worktree <epic-slug> <story-slug>
16
18
  npx @saga-ai/cli implement <story-slug>
17
19
  npx @saga-ai/cli dashboard
18
20
  ```
@@ -35,6 +37,43 @@ Creates the `.saga/` directory structure:
35
37
 
36
38
  Also updates `.gitignore` to ignore worktrees.
37
39
 
40
+ ### `saga find <query>`
41
+
42
+ Find an epic or story by slug or title using fuzzy search.
43
+
44
+ ```bash
45
+ saga find my-story
46
+ saga find "login feature"
47
+ saga find auth --type epic
48
+ ```
49
+
50
+ Options:
51
+ - `--type <type>` - Type to search for: `epic` or `story` (default: story)
52
+
53
+ Returns JSON with:
54
+ - `found: true` + `data` - Single match found
55
+ - `found: false` + `matches` - Multiple matches for disambiguation
56
+ - `found: false` + `error` - No matches found
57
+
58
+ Supports typo tolerance (e.g., "implment" matches "implement").
59
+
60
+ ### `saga worktree <epic-slug> <story-slug>`
61
+
62
+ Create a git worktree and branch for story isolation.
63
+
64
+ ```bash
65
+ saga worktree my-epic my-story
66
+ saga worktree auth-system login-form --path /path/to/project
67
+ ```
68
+
69
+ Creates:
70
+ - Branch: `story-<story-slug>-epic-<epic-slug>`
71
+ - Worktree: `.saga/worktrees/<epic-slug>/<story-slug>/`
72
+
73
+ Returns JSON with:
74
+ - `success: true` + `worktreePath`, `branch` - Worktree created
75
+ - `success: false` + `error` - Creation failed (branch exists, directory exists, etc.)
76
+
38
77
  ### `saga implement <story-slug>`
39
78
 
40
79
  Run autonomous story implementation using Claude workers.