@sniper.ai/cli 1.0.1 → 3.0.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 CHANGED
@@ -1,6 +1,30 @@
1
1
  # @sniper.ai/cli
2
2
 
3
- CLI tool for scaffolding and managing SNIPER-enabled projects.
3
+ [![npm version](https://img.shields.io/npm/v/@sniper.ai/cli)](https://www.npmjs.com/package/@sniper.ai/cli)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ CLI tool for scaffolding and managing [SNIPER](https://sniperai.dev/)-enabled projects.
7
+
8
+ ## What is SNIPER?
9
+
10
+ SNIPER (**S**pawn, **N**avigate, **I**mplement, **P**arallelize, **E**valuate, **R**elease) is an AI-powered project lifecycle framework that orchestrates Claude Code agent teams through structured phases -- from discovery and planning through implementation and release. Each phase spawns coordinated teams of specialized agents composed from layered personas.
11
+
12
+ ## Quick Start
13
+
14
+ ```bash
15
+ # 1. Install the CLI globally
16
+ npm install -g @sniper.ai/cli
17
+
18
+ # 2. Initialize SNIPER in your project
19
+ sniper init
20
+
21
+ # 3. (Optional) Install a language plugin
22
+ sniper plugin install @sniper.ai/plugin-typescript
23
+
24
+ # 4. Run the lifecycle in Claude Code
25
+ /sniper-flow # Auto-detect and run appropriate protocol
26
+ /sniper-flow --protocol full # Or specify a protocol explicitly
27
+ ```
4
28
 
5
29
  ## Installation
6
30
 
@@ -8,7 +32,9 @@ CLI tool for scaffolding and managing SNIPER-enabled projects.
8
32
  npm install -g @sniper.ai/cli
9
33
  ```
10
34
 
11
- ## Commands
35
+ ## CLI Commands (Terminal)
36
+
37
+ These commands are run in your terminal to manage the SNIPER installation.
12
38
 
13
39
  ### `sniper init`
14
40
 
@@ -26,41 +52,57 @@ Show the current lifecycle phase, artifact state, and team status.
26
52
  sniper status
27
53
  ```
28
54
 
29
- ### `sniper update`
55
+ ### `sniper migrate`
30
56
 
31
- Update the scaffolded framework files to the latest version from `@sniper.ai/core`.
57
+ Migrate a v2 SNIPER configuration to the v3 format.
32
58
 
33
59
  ```bash
34
- sniper update
60
+ sniper migrate
35
61
  ```
36
62
 
37
- ### `sniper add-pack <pack>`
63
+ ### `sniper plugin install/remove/list`
38
64
 
39
- Install a domain pack to inject project-specific context into agents.
65
+ Manage language plugins (TypeScript, Python, Go).
40
66
 
41
67
  ```bash
42
- sniper add-pack @sniper.ai/pack-sales-dialer
68
+ sniper plugin install @sniper.ai/plugin-typescript
69
+ sniper plugin remove @sniper.ai/plugin-typescript
70
+ sniper plugin list
43
71
  ```
44
72
 
45
- ### `sniper remove-pack <pack>`
73
+ ### `sniper knowledge`
46
74
 
47
- Remove an installed domain pack.
75
+ Manage domain knowledge files for MCP-based retrieval.
48
76
 
49
77
  ```bash
50
- sniper remove-pack @sniper.ai/pack-sales-dialer
78
+ sniper knowledge
51
79
  ```
52
80
 
53
- ### `sniper list-packs`
81
+ ### `sniper workspace`
54
82
 
55
- List all installed domain packs.
83
+ Manage SNIPER workspaces for multi-repo orchestration.
56
84
 
57
85
  ```bash
58
- sniper list-packs
86
+ sniper workspace
59
87
  ```
60
88
 
89
+ ## Slash Commands (Claude Code)
90
+
91
+ Once SNIPER is initialized, these slash commands are available inside Claude Code. They drive the agent team lifecycle.
92
+
93
+ | Command | Description |
94
+ |---------|-------------|
95
+ | `/sniper-flow` | Execute a SNIPER protocol (auto-detects scope or use `--protocol <name>`) |
96
+ | `/sniper-flow-headless` | Execute a protocol non-interactively for CI/CD environments |
97
+ | `/sniper-init` | Initialize SNIPER v3 in a new or existing project |
98
+ | `/sniper-review` | Manually trigger a review gate for the current phase |
99
+ | `/sniper-status` | Show current protocol progress and cost |
100
+
101
+ `/sniper-flow` is the core execution engine. It runs any of the 7 protocols: `full`, `feature`, `patch`, `ingest`, `explore`, `refactor`, `hotfix`.
102
+
61
103
  ## How It Works
62
104
 
63
- The CLI reads framework content from `@sniper.ai/core` and scaffolds it into your project's `.sniper/` directory. This gives Claude Code access to personas, team definitions, templates, and slash commands that drive the SNIPER lifecycle.
105
+ The CLI reads framework content from `@sniper.ai/core` and scaffolds it into your project's `.sniper/` directory. This gives Claude Code access to agents, protocols, templates, and slash commands that drive the SNIPER lifecycle.
64
106
 
65
107
  ## Tech Stack
66
108
 
@@ -78,6 +120,10 @@ pnpm dev # Watch mode
78
120
  pnpm build # Production build
79
121
  ```
80
122
 
123
+ ## Documentation
124
+
125
+ Full documentation is available at [sniperai.dev](https://sniperai.dev/).
126
+
81
127
  ## License
82
128
 
83
129
  MIT