skillo 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 ADDED
@@ -0,0 +1,261 @@
1
+ # Skillo CLI
2
+
3
+ Autonomous workflow learning & skill generation system.
4
+
5
+ **Learn workflows by observation, not explanation.**
6
+
7
+ ## Installation
8
+
9
+ ```bash
10
+ # Install globally
11
+ npm install -g skillo
12
+
13
+ # Or use with npx
14
+ npx skillo --help
15
+ ```
16
+
17
+ ## Quick Start
18
+
19
+ ```bash
20
+ # Login to Skillo platform (opens browser for OAuth)
21
+ skillo login
22
+
23
+ # Enable tracking for your project (privacy-first: opt-in only)
24
+ cd /path/to/your/project
25
+ skillo track
26
+
27
+ # Sync Claude Code history
28
+ skillo claude sync
29
+
30
+ # Check tracking status
31
+ skillo project status
32
+ ```
33
+
34
+ ## Commands
35
+
36
+ ### Authentication
37
+
38
+ ```bash
39
+ # Login with API key
40
+ skillo login <api-key>
41
+
42
+ # Login with custom platform URL
43
+ skillo login <api-key> --url http://localhost:3000/api/cli
44
+
45
+ # Check login status
46
+ skillo whoami
47
+
48
+ # Logout
49
+ skillo logout
50
+ ```
51
+
52
+ ### Project Tracking (Privacy-First)
53
+
54
+ ```bash
55
+ # Enable tracking for current project
56
+ skillo track
57
+
58
+ # Disable tracking
59
+ skillo untrack
60
+
61
+ # Check tracking status
62
+ skillo project status
63
+
64
+ # List all tracked projects
65
+ skillo project list
66
+ ```
67
+
68
+ ### Claude Code Sync
69
+
70
+ ```bash
71
+ # Sync Claude Code conversation history
72
+ skillo claude sync
73
+
74
+ # Sync specific project only
75
+ skillo claude sync --project /path/to/project
76
+ ```
77
+
78
+ ### Sync
79
+
80
+ ```bash
81
+ # Pull skills and patterns from platform
82
+ skillo sync --pull
83
+
84
+ # Push local patterns to platform
85
+ skillo sync --push
86
+
87
+ # Sync everything
88
+ skillo sync --push --pull
89
+
90
+ # Sync only skills
91
+ skillo sync --pull --skills
92
+ ```
93
+
94
+ ### Shell
95
+
96
+ ```bash
97
+ # Start a tracked shell session
98
+ skillo shell
99
+
100
+ # Use a specific shell
101
+ skillo shell -s /bin/zsh
102
+
103
+ # Track a specific project
104
+ skillo shell -p ./my-project
105
+ ```
106
+
107
+ ### Patterns
108
+
109
+ ```bash
110
+ # List detected patterns
111
+ skillo patterns list
112
+
113
+ # Show pattern details
114
+ skillo patterns show <id>
115
+
116
+ # Generate a skill from a pattern
117
+ skillo patterns generate <id>
118
+
119
+ # Ignore a pattern
120
+ skillo patterns ignore <id>
121
+ ```
122
+
123
+ ### Skills
124
+
125
+ ```bash
126
+ # List generated skills
127
+ skillo skills list
128
+
129
+ # Show skill details
130
+ skillo skills show <name>
131
+
132
+ # Delete a skill
133
+ skillo skills delete <name>
134
+
135
+ # Open skills directory
136
+ skillo skills open
137
+ ```
138
+
139
+ ### Daemon
140
+
141
+ ```bash
142
+ # Start background daemon
143
+ skillo start
144
+
145
+ # Run in foreground
146
+ skillo start -f
147
+
148
+ # Check status
149
+ skillo status
150
+
151
+ # Stop daemon
152
+ skillo stop
153
+
154
+ # View logs
155
+ skillo logs
156
+ skillo logs -f # Follow mode
157
+ ```
158
+
159
+ ### Config
160
+
161
+ ```bash
162
+ # Show configuration
163
+ skillo config show
164
+
165
+ # Get a value
166
+ skillo config get patternDetection.minCount
167
+
168
+ # Set a value
169
+ skillo config set patternDetection.minCount 5
170
+
171
+ # Reset to defaults
172
+ skillo config reset --force
173
+
174
+ # Show config file path
175
+ skillo config path
176
+ ```
177
+
178
+ ## Configuration
179
+
180
+ Configuration is stored in `~/.config/skillo/config.yaml`.
181
+
182
+ Key settings:
183
+
184
+ ```yaml
185
+ # Pattern detection
186
+ pattern_detection:
187
+ min_count: 3 # Occurrences before detection
188
+ session_timeout: 30 # Minutes of inactivity
189
+
190
+ # Privacy
191
+ privacy:
192
+ auto_redact: true # Redact sensitive data
193
+ track_output: false # Don't track command output
194
+
195
+ # Notifications
196
+ notifications:
197
+ enabled: true
198
+ style: inline # inline, desktop, or both
199
+
200
+ # Skill generation
201
+ skill_generation:
202
+ include_scripts: true
203
+ include_examples: true
204
+ ```
205
+
206
+ ## How It Works
207
+
208
+ 1. **Shadow Mode**: Run `skillo shell` to start a tracked terminal session. All commands are logged with context (working directory, timestamps, exit codes).
209
+
210
+ 2. **Pattern Detection**: The daemon analyzes your command history to identify repeated workflows. Patterns can be sequences of commands or frequently-used single commands.
211
+
212
+ 3. **Notification**: When a pattern crosses the detection threshold (default: 3 occurrences), you're notified. Choose to generate a skill, ignore the pattern, or defer.
213
+
214
+ 4. **Skill Generation**: The Skillo platform uses Claude to analyze the pattern and generate a production-ready skill. Skills are placed directly in `~/.claude/skills/` for immediate use with Claude Code.
215
+
216
+ 5. **Platform Sync**: Login with `skillo login` to sync patterns with the platform and generate skills using the platform's AI capabilities.
217
+
218
+ 6. **Claude Code Integration**: Generated skills work natively with Claude Code - they're automatically discovered and can be invoked by name.
219
+
220
+ ## Directory Structure
221
+
222
+ ```
223
+ ~/.skillo/ # Data directory
224
+ ├── skillo.db # SQLite database
225
+ ├── daemon.log # Daemon logs
226
+ └── daemon.pid # Daemon PID file
227
+
228
+ ~/.config/skillo/ # Config directory
229
+ └── config.yaml # Configuration
230
+
231
+ ~/.claude/skills/ # Skills directory (Claude Code)
232
+ ├── my-workflow/
233
+ │ ├── SKILL.md
234
+ │ └── scripts/
235
+ └── another-skill/
236
+ └── SKILL.md
237
+ ```
238
+
239
+ ## Programmatic Usage
240
+
241
+ ```typescript
242
+ import { SkilloDatabase, loadConfig } from "skillo";
243
+
244
+ // Load configuration
245
+ const config = loadConfig();
246
+
247
+ // Access database
248
+ const db = new SkilloDatabase();
249
+ const stats = db.getStats();
250
+ console.log(`Tracked ${stats.commandsTotal} commands`);
251
+
252
+ // Get patterns
253
+ const patterns = db.getPatterns({ status: "active" });
254
+ patterns.forEach((p) => console.log(p.description));
255
+
256
+ db.close();
257
+ ```
258
+
259
+ ## License
260
+
261
+ MIT
@@ -0,0 +1,11 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ ApiClient,
4
+ getApiClient
5
+ } from "./chunk-H2VPNNUK.js";
6
+ import "./chunk-SWPZL2RI.js";
7
+ export {
8
+ ApiClient,
9
+ getApiClient
10
+ };
11
+ //# sourceMappingURL=api-client-6OWIJNGI.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}