@prave/cli 1.0.2 → 1.0.3

package/dist/index.js

@@ -27,11 +27,35 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
 const program = new Command()
     .name('prave')
-    .description('Prave — Developer platform for Claude Skills')
-    .version(pkg.version);
-program.command('login').description('Authenticate this machine').action(loginCommand);
-program.command('logout').description('Remove stored credentials').action(logoutCommand);
-program.command('whoami').description('Show the signed-in user').action(whoamiCommand);
+    .description([
+    'Prave — Developer platform for Claude Skills.',
+    '',
+    '  Lifecycle: discover · install · author · sync · audit · ship.',
+    '  Targets ~/.claude/skills/ by default; multi-agent via `prave deploy`.',
+    '',
+    '  Quick start:',
+    '    prave login          # device-code auth in your browser',
+    '    prave search <q>     # discover community skills',
+    '    prave install <slug> # pull into ~/.claude/skills/',
+    '    prave usage hook install   # real-time invocation tracking',
+    '',
+    '  Docs:    https://prave.app/docs',
+    '  Issues:  https://github.com/eppstudio/prave/issues',
+].join('\n'))
+    .version(pkg.version)
+    .addHelpText('after', '\nRun `prave <cmd> --help` for command-specific options.');
+program
+    .command('login')
+    .description('Authenticate this machine via device-code (browser opens, no password is ever typed). Tokens are saved chmod-600 to ~/.prave/credentials.json and refresh automatically.')
+    .action(loginCommand);
+program
+    .command('logout')
+    .description('Remove stored credentials from ~/.prave/credentials.json. Re-run `prave login` to authenticate again.')
+    .action(logoutCommand);
+program
+    .command('whoami')
+    .description('Print the signed-in user, plan, and credentials path. Detects stale credentials predating the refresh-token flow.')
+    .action(whoamiCommand);
 program
     .command('import')
     .description('Scan ~/.claude/skills/ — optionally upload to Prave')
@@ -41,9 +65,9 @@ program
     .action(importCommand);
 program
     .command('install <slug>')
-    .description('Install a Skill into ~/.claude/skills/ (resolves deps)')
-    .option('--no-deps', 'skip transitive dependency resolution')
-    .option('--force', 'install even if SKILL.md is empty')
+    .description('Install a Skill from the registry into ~/.claude/skills/<slug>/. Resolves and installs transitive dependencies by default. Free plan caps at 5 installs/month — Pro and Max are unlimited.')
+    .option('--no-deps', 'skip transitive dependency resolution (don\'t pull deps the Skill declares)')
+    .option('--force', 'install even when the SKILL.md content is empty (rare; use for stub Skills)')
     .action(installCommand);
 program
     .command('uninstall <slug>')
@@ -61,11 +85,11 @@ program
     .action((slug, opts) => updateCommand(slug, opts));
 program
     .command('list')
-    .description('List installed Skills (default) or remote ones')
-    .option('--remote', 'list Skills from your Prave account')
-    .option('--verbose', 'show enriched intelligence (tokens, tier, agents)')
-    .option('--conflicts', 'only show skills involved in conflicts')
-    .option('--heavy', 'only show skills with >5k estimated tokens')
+    .description('List Skills installed locally (default) or stored on your Prave account (--remote).')
+    .option('--remote', 'fetch Skills you own + have installed from the Prave API instead of disk')
+    .option('--verbose', 'show enriched intelligence: estimated tokens, token tier, target agents')
+    .option('--conflicts', 'narrow to Skills flagged as conflicting with another by trigger overlap')
+    .option('--heavy', 'narrow to Skills above the heavy-tier threshold (>5k estimated tokens)')
     .action(listCommand);
 program.command('search <query>').description('Search public Skills').action(searchCommand);
 program
@@ -136,10 +160,56 @@ program
     .action(findCommand);
 program
     .command('deploy <skillname>')
-    .description('Deploy a skill to one or all configured agents')
-    .option('--agent <agent>', 'target a single agent (default: all)')
-    .option('--dry-run', 'log destinations but write no files')
+    .description('Deploy a Skill to every configured agent (Claude Code, Codex, Cursor, Gemini, Cline, Amp). Free plan deploys to Claude Code only; Pro and Max deploy across all six. The skill must already exist locally — use `prave install` first or point to a SKILL.md folder.')
+    .option('--agent <agent>', 'restrict deploy to a single agent (claude-code | codex | cursor | gemini | cline | amp)')
+    .option('--dry-run', 'log every destination path but write nothing — preview before committing')
     .action(deployCommand);
+// ─── Help command — full quick-reference ───────────────────────────
+program
+    .command('cheat')
+    .description('Print a one-page cheat sheet of every command.')
+    .action(() => {
+    console.log([
+        'Prave CLI cheat sheet',
+        '',
+        'Auth & account',
+        '  prave login                        # device-code browser auth',
+        '  prave logout                       # forget credentials',
+        '  prave whoami                       # signed-in user + plan',
+        '',
+        'Discover & install',
+        '  prave search <q>                   # public skill search',
+        '  prave find <q> [--smart|--local]   # smart cross-source search',
+        '  prave install <slug> [--no-deps]   # install into ~/.claude/skills/',
+        '  prave uninstall <slug>             # remove a local skill',
+        '  prave list [--remote] [--verbose]  # what is installed (or remote)',
+        '  prave export <slug> -o file.md     # dump SKILL.md without installing',
+        '',
+        'Authoring & sync',
+        '  prave import [--upload --public]   # publish ~/.claude/skills/ to Prave',
+        '  prave deploy <skill> [--agent x]   # mirror to other agents',
+        '  prave sync                         # pull every installed update',
+        '  prave update [slug] [--dry-run]    # diff + pull outdated skills',
+        '  prave diff <slug>                  # local vs registry diff',
+        '',
+        'Intelligence',
+        '  prave overview [--json]            # token cost summary',
+        '  prave whatdoes <skill>             # triggers, tokens, conflicts',
+        '  prave conflicts                    # cross-skill collision check',
+        '  prave optimize                     # heavy / underused / mergeable',
+        '',
+        'Usage tracking (Pro+)',
+        '  prave usage hook install           # real-time PostToolUse hook',
+        '  prave usage hook uninstall',
+        '  prave usage scan [--since 7d]      # transcript scanner',
+        '  prave usage status                 # hook health + recent counts',
+        '',
+        'Settings',
+        '  prave settings                     # configure agents + paths',
+        '',
+        'Docs:   https://prave.app/docs',
+    ].join('\n'));
+});
 program.parseAsync().catch((err) => {
     console.error(err.message);
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prave/cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Prave CLI — import, export, install, sync Claude Skills.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "open": "^10.1.0",
     "ora": "^8.0.1",
     "undici": "^6.18.0",
-    "@prave/shared": "1.0.2"
+    "@prave/shared": "1.0.3"
   },
   "devDependencies": {
     "@types/node": "^20.12.7",