@use-aistack/cli 0.3.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,26 +1,44 @@
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
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
11
  ## Commands
12
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.
16
+
17
+ ```sh
18
+ npx @use-aistack/cli sync
19
+ ```
20
+
21
+ Requires a one-time `login` first.
22
+
13
23
  ### `npx @use-aistack/cli login`
14
24
 
15
- Authenticate with your AI Stack account via browser.
25
+ Link this machine to your AI Stack account via browser.
16
26
 
17
27
  ```sh
18
28
  npx @use-aistack/cli login
19
29
  ```
20
30
 
31
+ ### `npx @use-aistack/cli connect claude`
32
+
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
+
21
39
  ### `npx @use-aistack/cli collect`
22
40
 
23
- Scan your project for AI config files and upload them.
41
+ Scan your project for AI config files (prompts, rules, skills, MCP setups) and upload them to your stack.
24
42
 
25
43
  ```sh
26
44
  cd your-project
@@ -29,12 +47,12 @@ npx @use-aistack/cli collect
29
47
 
30
48
  Detects: `.cursorrules`, `CLAUDE.md`, `AGENTS.md`, `.cursor/rules/`, `mcp.json`, skill directories, prompts, and global configs (`~/.claude/`, `~/.cursor/`, etc).
31
49
 
32
- ### `npx @use-aistack/cli create <slug>`
50
+ ### `npx @use-aistack/cli create`
33
51
 
34
- Clone a shared project's AI config files into your current directory.
52
+ Write your stack's AI config files into the current directory.
35
53
 
36
54
  ```sh
37
- npx @use-aistack/cli create my-project-abc123
55
+ npx @use-aistack/cli create
38
56
  ```
39
57
 
40
58
  ## Install globally (optional)
@@ -49,8 +67,8 @@ Then the same commands become:
49
67
 
50
68
  ```sh
51
69
  aistack login
70
+ aistack sync
52
71
  aistack collect
53
- aistack create <slug>
54
72
  ```
55
73
 
56
74
  ## Development
@@ -64,8 +82,7 @@ Test locally:
64
82
 
65
83
  ```sh
66
84
  node packages/cli/dist/index.js login
67
- node packages/cli/dist/index.js collect
68
- node packages/cli/dist/index.js create <slug>
85
+ node packages/cli/dist/index.js sync
69
86
  ```
70
87
 
71
88
  Set `AISTACK_URL=http://localhost:3019` to test against local dev server.