@use-aistack/cli 0.2.0 → 0.4.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,46 +1,74 @@
1
1
  # @use-aistack/cli
2
2
 
3
- Share and clone AI development configurations (prompts, rules, skills, MCP setups).
3
+ Measure and share your AI stack. The CLI scans your local Claude Code transcripts, shows you exactly what would go up, and publishes only after you approve in your terminal.
4
4
 
5
- ## Install
5
+ Run on-demand with `npx` — no install required:
6
6
 
7
7
  ```sh
8
- npx @use-aistack/cli <command>
8
+ npx @use-aistack/cli sync
9
9
  ```
10
10
 
11
- Or install globally:
11
+ ## Commands
12
+
13
+ ### `npx @use-aistack/cli sync`
14
+
15
+ The default command. Scan your local transcripts (rolling 30 days), review the full summary, and publish the measured layer to your stack. Nothing leaves your machine without your explicit approval at the prompt. Raw transcripts, prompts, and paths never leave at all — only aggregates.
12
16
 
13
17
  ```sh
14
- npm i -g @use-aistack/cli
18
+ npx @use-aistack/cli sync
15
19
  ```
16
20
 
17
- ## Commands
21
+ Requires a one-time `login` first.
18
22
 
19
- ### `aistack login`
23
+ ### `npx @use-aistack/cli login`
20
24
 
21
- Authenticate with your AI Stack account via browser.
25
+ Link this machine to your AI Stack account via browser.
22
26
 
23
27
  ```sh
24
- aistack login
28
+ npx @use-aistack/cli login
25
29
  ```
26
30
 
27
- ### `aistack collect`
31
+ ### `npx @use-aistack/cli connect claude`
28
32
 
29
- Scan your project for AI config files and upload them.
33
+ Optional: install the in-session sync surface for Claude Code the `aistack` MCP server (user scope) plus the `aistack-sync` Skill. After that, say "sync my stack" in any Claude Code session. Both halves install together or not at all.
34
+
35
+ ```sh
36
+ npx @use-aistack/cli connect claude
37
+ ```
38
+
39
+ ### `npx @use-aistack/cli collect`
40
+
41
+ Scan your project for AI config files (prompts, rules, skills, MCP setups) and upload them to your stack.
30
42
 
31
43
  ```sh
32
44
  cd your-project
33
- aistack collect
45
+ npx @use-aistack/cli collect
34
46
  ```
35
47
 
36
48
  Detects: `.cursorrules`, `CLAUDE.md`, `AGENTS.md`, `.cursor/rules/`, `mcp.json`, skill directories, prompts, and global configs (`~/.claude/`, `~/.cursor/`, etc).
37
49
 
38
- ### `aistack create <slug>`
50
+ ### `npx @use-aistack/cli create`
39
51
 
40
- Clone a shared project's AI config files into your current directory.
52
+ Write your stack's AI config files into the current directory.
41
53
 
42
54
  ```sh
43
- aistack create my-project-abc123
55
+ npx @use-aistack/cli create
56
+ ```
57
+
58
+ ## Install globally (optional)
59
+
60
+ If you'd rather type `aistack` instead of `npx @use-aistack/cli` every time, install it globally:
61
+
62
+ ```sh
63
+ npm i -g @use-aistack/cli
64
+ ```
65
+
66
+ Then the same commands become:
67
+
68
+ ```sh
69
+ aistack login
70
+ aistack sync
71
+ aistack collect
44
72
  ```
45
73
 
46
74
  ## Development
@@ -54,8 +82,7 @@ Test locally:
54
82
 
55
83
  ```sh
56
84
  node packages/cli/dist/index.js login
57
- node packages/cli/dist/index.js collect
58
- node packages/cli/dist/index.js create <slug>
85
+ node packages/cli/dist/index.js sync
59
86
  ```
60
87
 
61
88
  Set `AISTACK_URL=http://localhost:3019` to test against local dev server.