@devkitvault/recall 1.0.5 → 1.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) devkitvault
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) devkitvault
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,81 +1,93 @@
-# @devkitvault/recall
-
-**recall** is a cloud-synced CLI command vault — save terminal commands once, search and run them from any machine.
-
-Works with [recall.devkitvault.com](https://recall.devkitvault.com) and the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd).
-
-## Requirements
-
-- [Node.js](https://nodejs.org/) **18 or newer**
-
-## Install
-
-```sh
-npm install -g @devkitvault/recall
-```
-
-Verify the install:
-
-```sh
-recall --version
-recall doctor
-```
-
-## Quick start
-
-```sh
-recall auth login
-recall save "docker compose up -d" --name start-stack --tags docker
-recall search docker
-recall list
-recall run start-stack
-```
-
-Run `recall --help` for the full command list.
-
-## Authentication
-
-After `recall auth login`, your session is stored locally so you stay signed in between runs.
-
-```sh
-recall auth login      # sign in (browser or email/password)
-recall auth logout     # sign out on this machine
-recall auth whoami     # show the signed-in account
-```
-
-## Prefer a standalone binary?
-
-If you do not want Node.js, use the native installer instead — same commands, no runtime required:
-
-- **macOS / Linux:** `curl -fsSL https://devkitvault.com/recall/install.sh | sh`
-- **Windows:** `irm https://devkitvault.com/recall/install.ps1 | iex`
-
-See [devkitvault.com/recall](https://devkitvault.com/recall) for downloads and docs.
-
-## Update
-
-```sh
-npm update -g @devkitvault/recall
-```
-
-## Troubleshooting
-
-```sh
-recall doctor          # check install, auth, and API connectivity
-recall auth whoami     # confirm you are signed in
-```
-
-If something still fails, open an issue on [GitHub](https://github.com/devkitvault/recall/issues) or visit [recall.devkitvault.com](https://recall.devkitvault.com).
-
-## Links
-
-|           |                                                                                           |
-| --------- | ----------------------------------------------------------------------------------------- |
-| Website   | [devkitvault.com/recall](https://devkitvault.com)                                         |
-| Dashboard | [recall.devkitvault.com](https://recall.devkitvault.com)                                  |
-| VS Code   | [Marketplace](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd) |
-| Issues    | [github.com/devkitvault/recall](https://github.com/devkitvault/recall/issues)             |
-
-## License
-
-MIT — see [LICENSE](./LICENSE). © [devkitvault](https://devkitvault.com)
+# @devkitvault/recall
+
+**recall** is an AI terminal copilot with a personal command vault. Ask in English. It prints a command. It does not run it. Saved commands can answer first so you do not spend an AI request.
+
+Works with [recall.devkitvault.com](https://recall.devkitvault.com) and the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd).
+
+## Requirements
+
+- [Node.js](https://nodejs.org/) **18 or newer**
+
+## Install
+
+```sh
+npm install -g @devkitvault/recall
+```
+
+`rec` is the same command as `recall`.
+
+```sh
+recall --version
+recall doctor
+```
+
+## Quick start
+
+```sh
+recall auth login
+recall "find the 10 biggest files in this directory"
+rec "that docker command from last week"
+recall
+```
+
+No-args `recall` opens an Ask session (`Recall >`). `/save [name]` stores the last suggestion. `/exit` leaves.
+
+```sh
+recall playbook save deploy "docker compose up -d" "pnpm migrate"
+recall playbook run deploy --dry-run
+```
+
+`recall playbook run` executes steps. Ask never does.
+
+Ask prints a suggestion (`source` is `vault`, `cache`, or `llm`). Copy or save it yourself.
+
+```sh
+recall save "docker compose up -d" --name docker --tags docker
+recall run docker
+```
+
+Run `recall --help` for the full command list. Free plans include **20 AI asks / month**; Pro includes **500**.
+
+## Authentication
+
+```sh
+recall auth login
+recall auth logout
+recall whoami
+```
+
+## Prefer a standalone binary?
+
+- **macOS / Linux:** `curl -fsSL https://devkitvault.com/recall/install.sh | sh`
+- **Windows:** `irm https://devkitvault.com/recall/install.ps1 | iex`
+
+See [recall.devkitvault.com/docs/install](https://recall.devkitvault.com/docs/install).
+
+## Update
+
+```sh
+npm update -g @devkitvault/recall
+```
+
+## Troubleshooting
+
+```sh
+recall doctor
+recall whoami
+```
+
+If something still fails, open an issue on [GitHub](https://github.com/devkitvault/recall/issues) or visit [recall.devkitvault.com](https://recall.devkitvault.com).
+
+## Links
+
+|           |                                                                                           |
+| --------- | ----------------------------------------------------------------------------------------- |
+| Website   | [devkitvault.com/recall](https://devkitvault.com)                                         |
+| Docs      | [recall.devkitvault.com/docs](https://recall.devkitvault.com/docs)                        |
+| Dashboard | [recall.devkitvault.com](https://recall.devkitvault.com)                                  |
+| VS Code   | [Marketplace](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd) |
+| Issues    | [github.com/devkitvault/recall](https://github.com/devkitvault/recall/issues)             |
+
+## License
+
+MIT — see [LICENSE](./LICENSE). © [devkitvault](https://devkitvault.com)

package/dist/commands/ask.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askCommand = void 0;
+exports.runAsk = runAsk;
+const chalk_1 = __importDefault(require("chalk"));
+const commander_1 = require("commander");
+const inquirer_1 = __importDefault(require("inquirer"));
+const ora_1 = __importDefault(require("ora"));
+const api_1 = require("../lib/api");
+const auth_1 = require("../lib/auth");
+const events_1 = require("../lib/events");
+const runtime_1 = require("../lib/runtime");
+function riskColor(risk) {
+    if (risk === 'DANGEROUS')
+        return chalk_1.default.red(risk);
+    if (risk === 'CAUTION')
+        return chalk_1.default.yellow(risk);
+    return chalk_1.default.green(risk);
+}
+async function runAsk(query) {
+    const token = await (0, auth_1.requireAuth)();
+    const runtime = (0, runtime_1.detectRuntime)();
+    const spinner = (0, ora_1.default)('Looking up...').start();
+    try {
+        const result = await api_1.ApiClient.post('/ai/resolve', {
+            query,
+            os: runtime.os,
+            shell: runtime.shell,
+            mode: 'ask',
+        }, token);
+        spinner.stop();
+        console.log();
+        console.log(`  ${chalk_1.default.white(result.command)}`);
+        if (result.explanation) {
+            console.log(`  ${chalk_1.default.dim(result.explanation)}`);
+        }
+        console.log();
+        console.log(`  ${chalk_1.default.dim('shell:')} ${result.shell}    ${chalk_1.default.dim('risk:')} ${riskColor(result.risk)}    ${chalk_1.default.dim('source:')} ${result.source}`);
+        if (result.source === 'vault') {
+            console.log(chalk_1.default.dim('  from your vault'));
+        }
+        if (result.remaining !== null) {
+            console.log(`  ${chalk_1.default.dim(`ai left this month: ${result.remaining}`)}`);
+        }
+        if (result.alternatives?.length) {
+            console.log();
+            for (const alt of result.alternatives) {
+                console.log(`  ${chalk_1.default.dim('alt')} ${alt}`);
+            }
+        }
+        console.log();
+        console.log(chalk_1.default.dim('  Ask mode does not run commands. Copy or save this yourself.'));
+        console.log();
+        if (result.source === 'vault') {
+            await (0, events_1.track)('ai_accepted', { source: result.source, risk: result.risk, saved: false });
+            return;
+        }
+        const { save } = await inquirer_1.default.prompt([{
+                type: 'confirm',
+                name: 'save',
+                message: 'Save this command?',
+                default: false,
+            }]);
+        if (!save)
+            return;
+        const { name } = await inquirer_1.default.prompt([{
+                type: 'input',
+                name: 'name',
+                message: 'Name (optional):',
+            }]);
+        await api_1.ApiClient.post('/commands', {
+            command: result.command,
+            name: name?.trim() || undefined,
+        }, token);
+        await (0, events_1.track)('ai_accepted', { source: result.source, risk: result.risk, saved: true });
+        console.log(chalk_1.default.green('\n  Saved.\n'));
+    }
+    catch (err) {
+        spinner.stop();
+        if (err instanceof api_1.ApiError && err.status === 403 && err.body?.upgrade) {
+            console.log(chalk_1.default.yellow(`\n  ${err.message}`));
+            console.log(chalk_1.default.dim(`  Upgrade at ${chalk_1.default.white(err.body.upgrade)}\n`));
+            return;
+        }
+        if (err instanceof api_1.ApiError) {
+            console.error(chalk_1.default.red(`\n  ${err.message}\n`));
+            return;
+        }
+        console.error(chalk_1.default.red('\n  Failed to resolve that request.\n'));
+    }
+}
+exports.askCommand = new commander_1.Command('ask')
+    .description('Suggest a command from natural language (does not run it)')
+    .argument('<query...>', 'What you want to do')
+    .action(async (parts) => {
+    await runAsk(parts.join(' '));
+});

package/dist/commands/auth/login.js

@@ -70,6 +70,8 @@ async function loginWithCredentials() {
         (0, config_1.saveConfig)({ username });
         spinner.succeed(chalk_1.default.green('Authenticated successfully!'));
         console.log(chalk_1.default.dim(`\n  Logged in as ${chalk_1.default.white(username)}\n`));
+        const { track } = await Promise.resolve().then(() => __importStar(require('../../lib/events')));
+        await track('cli_login', { method: 'credentials' });
     }
     catch (err) {
         spinner.fail(chalk_1.default.red('Authentication failed'));
@@ -115,13 +117,13 @@ async function loginWithBrowser() {
             }
             // Loopback callback: tell the browser to close the socket so server.close() can finish promptly.
             res.writeHead(200, { 'Content-Type': 'text/html', ...closeHeaders });
-            res.end(`<!DOCTYPE html>
-<html>
-  <head><meta charset="utf-8"></head>
-  <body style="font-family:system-ui;max-width:480px;margin:80px auto;text-align:center;background:#080b0f;color:#e2e8f0;">
-    <h2 style="color:#4ade80;margin-bottom:12px;">✓ Authenticated!</h2>
-    <p style="color:#6b7e94;font-family:monospace;">You can close this tab and return to your terminal.</p>
-  </body>
+            res.end(`<!DOCTYPE html>
+<html>
+  <head><meta charset="utf-8"></head>
+  <body style="font-family:system-ui;max-width:480px;margin:80px auto;text-align:center;background:#080b0f;color:#e2e8f0;">
+    <h2 style="color:#4ade80;margin-bottom:12px;">✓ Authenticated!</h2>
+    <p style="color:#6b7e94;font-family:monospace;">You can close this tab and return to your terminal.</p>
+  </body>
 </html>`);
             const srv = server;
             srv.closeAllConnections?.();
@@ -145,6 +147,8 @@ async function loginWithBrowser() {
     (0, config_1.saveConfig)({ username });
     spinner.succeed(chalk_1.default.green('Authenticated successfully!'));
     console.log(chalk_1.default.dim(`\n  Logged in as ${chalk_1.default.white(username)}\n`));
+    const { track } = await Promise.resolve().then(() => __importStar(require('../../lib/events')));
+    await track('cli_login', { method: 'browser' });
 }
 exports.loginCommand = new commander_1.Command('login')
     .description('Log in to recall')

package/dist/commands/completion.js

@@ -11,7 +11,7 @@ const ALL_COMMANDS = [
     'export', 'import', 'sync', 'whoami', 'upgrade', 'config',
     'pin', 'alias', 'history', 'share', 'snippet', 'env',
     'group', 'org', 'audit', 'approve', 'template', 'doctor',
-    'completion',
+    'completion', 'ask',
 ];
 const AUTH_CMDS = ['register', 'login', 'logout', 'forgot', 'reset'];
 const GROUP_CMDS = ['create', 'list', 'show', 'add', 'remove', 'delete', 'rename'];
@@ -24,109 +24,109 @@ const TEMPLATE_CMDS = ['save', 'list', 'show', 'run', 'delete'];
 const APPROVE_CMDS = ['request', 'grant', 'list'];
 const CONFIG_CMDS = ['show', 'set', 'switch', 'reset'];
 function bashCompletion() {
-    return `# recall bash completion
-# Add this to ~/.bashrc or ~/.bash_profile:
-# eval "$(recall completion bash)"
-
-_recall_completion() {
-  local cur prev words
-  COMPREPLY=()
-  cur="\${COMP_WORDS[COMP_CWORD]}"
-  prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  words=("\${COMP_WORDS[@]}")
-
-  local commands="${ALL_COMMANDS.join(' ')}"
-
-  case "\${words[1]}" in
-    auth)     COMPREPLY=($(compgen -W "${AUTH_CMDS.join(' ')}" -- "$cur")) ;;
-    group)    COMPREPLY=($(compgen -W "${GROUP_CMDS.join(' ')}" -- "$cur")) ;;
-    org)      COMPREPLY=($(compgen -W "${ORG_CMDS.join(' ')}" -- "$cur")) ;;
-    alias)    COMPREPLY=($(compgen -W "${ALIAS_CMDS.join(' ')}" -- "$cur")) ;;
-    share)    COMPREPLY=($(compgen -W "${SHARE_CMDS.join(' ')}" -- "$cur")) ;;
-    snippet)  COMPREPLY=($(compgen -W "${SNIPPET_CMDS.join(' ')}" -- "$cur")) ;;
-    env)      COMPREPLY=($(compgen -W "${ENV_CMDS.join(' ')}" -- "$cur")) ;;
-    template) COMPREPLY=($(compgen -W "${TEMPLATE_CMDS.join(' ')}" -- "$cur")) ;;
-    approve)  COMPREPLY=($(compgen -W "${APPROVE_CMDS.join(' ')}" -- "$cur")) ;;
-    config)   COMPREPLY=($(compgen -W "${CONFIG_CMDS.join(' ')}" -- "$cur")) ;;
-    *)        COMPREPLY=($(compgen -W "$commands" -- "$cur")) ;;
-  esac
-
-  return 0
-}
-
+    return `# recall bash completion
+# Add this to ~/.bashrc or ~/.bash_profile:
+# eval "$(recall completion bash)"
+
+_recall_completion() {
+  local cur prev words
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  words=("\${COMP_WORDS[@]}")
+
+  local commands="${ALL_COMMANDS.join(' ')}"
+
+  case "\${words[1]}" in
+    auth)     COMPREPLY=($(compgen -W "${AUTH_CMDS.join(' ')}" -- "$cur")) ;;
+    group)    COMPREPLY=($(compgen -W "${GROUP_CMDS.join(' ')}" -- "$cur")) ;;
+    org)      COMPREPLY=($(compgen -W "${ORG_CMDS.join(' ')}" -- "$cur")) ;;
+    alias)    COMPREPLY=($(compgen -W "${ALIAS_CMDS.join(' ')}" -- "$cur")) ;;
+    share)    COMPREPLY=($(compgen -W "${SHARE_CMDS.join(' ')}" -- "$cur")) ;;
+    snippet)  COMPREPLY=($(compgen -W "${SNIPPET_CMDS.join(' ')}" -- "$cur")) ;;
+    env)      COMPREPLY=($(compgen -W "${ENV_CMDS.join(' ')}" -- "$cur")) ;;
+    template) COMPREPLY=($(compgen -W "${TEMPLATE_CMDS.join(' ')}" -- "$cur")) ;;
+    approve)  COMPREPLY=($(compgen -W "${APPROVE_CMDS.join(' ')}" -- "$cur")) ;;
+    config)   COMPREPLY=($(compgen -W "${CONFIG_CMDS.join(' ')}" -- "$cur")) ;;
+    *)        COMPREPLY=($(compgen -W "$commands" -- "$cur")) ;;
+  esac
+
+  return 0
+}
+
 complete -F _recall_completion recall`;
 }
 function zshCompletion() {
-    return `# recall zsh completion
-# Add this to ~/.zshrc:
-# eval "$(recall completion zsh)"
-
-_recall() {
-  local state
-
-  _arguments \\
-    '1: :->command' \\
-    '*: :->args'
-
-  case $state in
-    command)
-      local commands=(${ALL_COMMANDS.map(c => `'${c}'`).join(' ')})
-      _describe 'command' commands
-      ;;
-    args)
-      case $words[2] in
-        auth)     local sub=(${AUTH_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        group)    local sub=(${GROUP_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        org)      local sub=(${ORG_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        alias)    local sub=(${ALIAS_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        share)    local sub=(${SHARE_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        snippet)  local sub=(${SNIPPET_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        env)      local sub=(${ENV_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        template) local sub=(${TEMPLATE_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        approve)  local sub=(${APPROVE_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-        config)   local sub=(${CONFIG_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
-      esac
-      ;;
-  esac
-}
-
+    return `# recall zsh completion
+# Add this to ~/.zshrc:
+# eval "$(recall completion zsh)"
+
+_recall() {
+  local state
+
+  _arguments \\
+    '1: :->command' \\
+    '*: :->args'
+
+  case $state in
+    command)
+      local commands=(${ALL_COMMANDS.map(c => `'${c}'`).join(' ')})
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[2] in
+        auth)     local sub=(${AUTH_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        group)    local sub=(${GROUP_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        org)      local sub=(${ORG_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        alias)    local sub=(${ALIAS_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        share)    local sub=(${SHARE_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        snippet)  local sub=(${SNIPPET_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        env)      local sub=(${ENV_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        template) local sub=(${TEMPLATE_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        approve)  local sub=(${APPROVE_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+        config)   local sub=(${CONFIG_CMDS.map(c => `'${c}'`).join(' ')}) && _describe 'subcommand' sub ;;
+      esac
+      ;;
+  esac
+}
+
 compdef _recall recall`;
 }
 function psCompletion() {
-    return `# recall PowerShell completion
-# Add this to your PowerShell profile ($PROFILE):
-# recall completion ps | Out-String | Invoke-Expression
-
-Register-ArgumentCompleter -Native -CommandName recall -ScriptBlock {
-  param($wordToComplete, $commandAst, $cursorPosition)
-
-  $commands = @(${ALL_COMMANDS.map(c => `'${c}'`).join(', ')})
-  $tokens   = $commandAst.CommandElements
-
-  $subCommands = @{
-    'auth'     = @(${AUTH_CMDS.map(c => `'${c}'`).join(', ')})
-    'group'    = @(${GROUP_CMDS.map(c => `'${c}'`).join(', ')})
-    'org'      = @(${ORG_CMDS.map(c => `'${c}'`).join(', ')})
-    'alias'    = @(${ALIAS_CMDS.map(c => `'${c}'`).join(', ')})
-    'share'    = @(${SHARE_CMDS.map(c => `'${c}'`).join(', ')})
-    'snippet'  = @(${SNIPPET_CMDS.map(c => `'${c}'`).join(', ')})
-    'env'      = @(${ENV_CMDS.map(c => `'${c}'`).join(', ')})
-    'template' = @(${TEMPLATE_CMDS.map(c => `'${c}'`).join(', ')})
-    'approve'  = @(${APPROVE_CMDS.map(c => `'${c}'`).join(', ')})
-    'config'   = @(${CONFIG_CMDS.map(c => `'${c}'`).join(', ')})
-  }
-
-  if ($tokens.Count -ge 2) {
-    $mainCmd = $tokens[1].Value
-    if ($subCommands.ContainsKey($mainCmd)) {
-      $subCommands[$mainCmd] | Where-Object { $_ -like "$wordToComplete*" } |
-        ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
-      return
-    }
-  }
-
-  $commands | Where-Object { $_ -like "$wordToComplete*" } |
-    ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+    return `# recall PowerShell completion
+# Add this to your PowerShell profile ($PROFILE):
+# recall completion ps | Out-String | Invoke-Expression
+
+Register-ArgumentCompleter -Native -CommandName recall -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+
+  $commands = @(${ALL_COMMANDS.map(c => `'${c}'`).join(', ')})
+  $tokens   = $commandAst.CommandElements
+
+  $subCommands = @{
+    'auth'     = @(${AUTH_CMDS.map(c => `'${c}'`).join(', ')})
+    'group'    = @(${GROUP_CMDS.map(c => `'${c}'`).join(', ')})
+    'org'      = @(${ORG_CMDS.map(c => `'${c}'`).join(', ')})
+    'alias'    = @(${ALIAS_CMDS.map(c => `'${c}'`).join(', ')})
+    'share'    = @(${SHARE_CMDS.map(c => `'${c}'`).join(', ')})
+    'snippet'  = @(${SNIPPET_CMDS.map(c => `'${c}'`).join(', ')})
+    'env'      = @(${ENV_CMDS.map(c => `'${c}'`).join(', ')})
+    'template' = @(${TEMPLATE_CMDS.map(c => `'${c}'`).join(', ')})
+    'approve'  = @(${APPROVE_CMDS.map(c => `'${c}'`).join(', ')})
+    'config'   = @(${CONFIG_CMDS.map(c => `'${c}'`).join(', ')})
+  }
+
+  if ($tokens.Count -ge 2) {
+    $mainCmd = $tokens[1].Value
+    if ($subCommands.ContainsKey($mainCmd)) {
+      $subCommands[$mainCmd] | Where-Object { $_ -like "$wordToComplete*" } |
+        ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+      return
+    }
+  }
+
+  $commands | Where-Object { $_ -like "$wordToComplete*" } |
+    ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
 }`;
 }
 exports.completionCommand = new commander_1.Command('completion')

package/dist/commands/upgrade.js

@@ -16,7 +16,8 @@ const PLANS = {
         label: 'Free',
         price: '$0/month',
         features: [
-            'Unlimited command saves',
+            '20 AI asks / month',
+            '100 command saves',
             'Search and filter',
             'Export as JSON or shell script',
             'Cross-machine sync',
@@ -24,22 +25,21 @@ const PLANS = {
     },
     pro: {
         label: 'Pro',
-        price: '$9/month',
+        price: '$6/month',
         features: [
-            'Everything in Free',
+            '500 AI asks / month',
+            'Unlimited commands',
             'Command groups',
             'Share commands via link',
-            'Priority support',
         ],
     },
     team: {
         label: 'Team',
-        price: '$19/month per seat',
+        price: '$12/month per seat',
         features: [
             'Everything in Pro',
             'Org-level vaults',
             'Role-based access',
-            'SSO / SAML',
             'Audit log',
         ],
     },
@@ -81,12 +81,12 @@ exports.upgradeCommand = new commander_1.Command('upgrade')
     }
     const upgradeTo = currentPlan === 'free'
         ? [
-            { name: 'Upgrade to Pro  — $9/month', value: 'pro' },
-            { name: 'Upgrade to Team — $19/month per seat', value: 'team' },
+            { name: 'Upgrade to Pro  — $6/month', value: 'pro' },
+            { name: 'Upgrade to Team — $12/month per seat', value: 'team' },
             { name: 'Maybe later', value: 'exit' },
         ]
         : [
-            { name: 'Upgrade to Team — $19/month per seat', value: 'team' },
+            { name: 'Upgrade to Team — $12/month per seat', value: 'team' },
             { name: 'Maybe later', value: 'exit' },
         ];
     const { choice } = await inquirer_1.default.prompt([

package/dist/index.js

@@ -8,6 +8,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
 const alias_1 = require("./commands/alias");
 const approve_1 = require("./commands/approve");
+const ask_1 = require("./commands/ask");
 const audit_1 = require("./commands/audit");
 const index_1 = require("./commands/auth/index");
 const completion_1 = require("./commands/completion");
@@ -35,11 +36,26 @@ const update_1 = require("./commands/update");
 const upgrade_1 = require("./commands/upgrade");
 const whoami_1 = require("./commands/whoami");
 const config_2 = require("./lib/config");
+const events_1 = require("./lib/events");
+const KNOWN = new Set([
+    'auth', 'save', 'list', 'run', 'delete', 'search', 'update',
+    'export', 'import', 'whoami', 'upgrade', 'sync', 'group', 'org',
+    'config', 'pin', 'alias', 'history', 'share', 'snippet', 'env',
+    'audit', 'approve', 'template', 'doctor', 'completion', 'feedback',
+    'support', 'ask', 'help',
+]);
+const rawArgs = process.argv.slice(2);
+if (rawArgs.length > 0
+    && !rawArgs[0].startsWith('-')
+    && !KNOWN.has(rawArgs[0])) {
+    process.argv = [process.argv[0], process.argv[1], 'ask', ...rawArgs];
+}
 const program = new commander_1.Command();
 program
     .name('recall')
-    .description(chalk_1.default.cyan('Save and retrieve your CLI commands from anywhere'))
+    .description(chalk_1.default.cyan('Your terminal remembers how you work'))
     .version(config_2.APP_VERSION);
+program.addCommand(ask_1.askCommand);
 program.addCommand(index_1.authCommand);
 program.addCommand(save_1.saveCommand);
 program.addCommand(list_1.listCommand);
@@ -68,4 +84,12 @@ program.addCommand(doctor_1.doctorCommand);
 program.addCommand(completion_1.completionCommand);
 program.addCommand(feedback_1.feedbackCommand);
 program.addCommand(support_1.supportCommand);
-program.parse();
+async function main() {
+    void (0, events_1.trackInstalledOnce)();
+    await program.parseAsync();
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : 'Unknown error';
+    console.error(chalk_1.default.red(`\n  ${message}\n`));
+    process.exit(1);
+});

package/dist/lib/auth.js

@@ -40,42 +40,81 @@ exports.getToken = getToken;
 exports.setToken = setToken;
 exports.deleteToken = deleteToken;
 exports.requireAuth = requireAuth;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
-const TOKEN_FILE = require('path').join(require('os').homedir(), '.recall', 'token');
-async function getToken() {
+const TOKEN_FILE = node_path_1.default.join(node_os_1.default.homedir(), '.recall', 'token');
+async function loadKeytar() {
+    try {
+        const loaded = await Promise.resolve().then(() => __importStar(require('keytar')));
+        const api = loaded.default ?? loaded;
+        if (typeof api.getPassword !== 'function' || typeof api.setPassword !== 'function') {
+            return null;
+        }
+        return api;
+    }
+    catch {
+        return null;
+    }
+}
+function readTokenFile() {
     try {
-        const keytar = await Promise.resolve().then(() => __importStar(require('keytar')));
-        return keytar.getPassword('recall', 'token');
+        if (!node_fs_1.default.existsSync(TOKEN_FILE))
+            return null;
+        const token = node_fs_1.default.readFileSync(TOKEN_FILE, 'utf-8').trim();
+        return token || null;
     }
     catch {
-        // fallback to file if keytar not available
-        const fs = require('fs');
-        if (fs.existsSync(TOKEN_FILE))
-            return fs.readFileSync(TOKEN_FILE, 'utf-8').trim();
         return null;
     }
 }
+function writeTokenFile(token) {
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(TOKEN_FILE), { recursive: true });
+    node_fs_1.default.writeFileSync(TOKEN_FILE, token, { mode: 0o600 });
+}
+async function getToken() {
+    const keytar = await loadKeytar();
+    if (keytar) {
+        try {
+            const fromKeytar = await keytar.getPassword('recall', 'token');
+            if (fromKeytar)
+                return fromKeytar;
+        }
+        catch {
+            // fall through to file
+        }
+    }
+    return readTokenFile();
+}
 async function setToken(token) {
+    writeTokenFile(token);
+    const keytar = await loadKeytar();
+    if (!keytar)
+        return;
     try {
-        const keytar = await Promise.resolve().then(() => __importStar(require('keytar')));
         await keytar.setPassword('recall', 'token', token);
     }
     catch {
-        const fs = require('fs');
-        const path = require('path');
-        fs.mkdirSync(path.dirname(TOKEN_FILE), { recursive: true });
-        fs.writeFileSync(TOKEN_FILE, token, { mode: 0o600 });
+        // file is already written
     }
 }
 async function deleteToken() {
     try {
-        const keytar = await Promise.resolve().then(() => __importStar(require('keytar')));
+        if (node_fs_1.default.existsSync(TOKEN_FILE))
+            node_fs_1.default.unlinkSync(TOKEN_FILE);
+    }
+    catch {
+        // ignore
+    }
+    const keytar = await loadKeytar();
+    if (!keytar)
+        return;
+    try {
         await keytar.deletePassword('recall', 'token');
     }
     catch {
-        const fs = require('fs');
-        if (fs.existsSync(TOKEN_FILE))
-            fs.unlinkSync(TOKEN_FILE);
+        // ignore
     }
 }
 async function requireAuth() {

package/dist/lib/config.js

@@ -11,7 +11,7 @@ const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.recall');
 const CONFIG_FILE = path_1.default.join(CONFIG_DIR, 'config.json');
-exports.APP_VERSION = "1.0.1";
+exports.APP_VERSION = "2.5.0";
 exports.ENVIRONMENTS = {
     production: 'https://api.devkitvault.com',
     local: 'http://127.0.0.1:3001',

package/dist/lib/events.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.track = track;
+exports.trackInstalledOnce = trackInstalledOnce;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const api_1 = require("./api");
+const auth_1 = require("./auth");
+const config_1 = require("./config");
+const FLAG_FILE = path_1.default.join(os_1.default.homedir(), '.recall', 'installed');
+function markInstalled() {
+    try {
+        if (fs_1.default.existsSync(FLAG_FILE))
+            return false;
+        fs_1.default.mkdirSync(path_1.default.dirname(FLAG_FILE), { recursive: true });
+        fs_1.default.writeFileSync(FLAG_FILE, new Date().toISOString(), { mode: 0o600 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function track(name, properties) {
+    try {
+        const token = await (0, auth_1.getToken)();
+        await api_1.ApiClient.post('/events', { name, properties: properties ?? {} }, token ?? undefined);
+    }
+    catch {
+        // never block the CLI on analytics
+    }
+}
+async function trackInstalledOnce() {
+    if (!markInstalled())
+        return;
+    await track('cli_installed', { version: config_1.APP_VERSION });
+}

package/dist/lib/runtime.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRuntime = detectRuntime;
+function detectRuntime() {
+    const os = process.platform === 'win32'
+        ? 'windows'
+        : process.platform === 'darwin'
+            ? 'macos'
+            : 'linux';
+    if (os === 'windows') {
+        const shellEnv = (process.env.SHELL ?? '').toLowerCase();
+        if (shellEnv.includes('zsh'))
+            return { os, shell: 'zsh' };
+        if (shellEnv.includes('bash'))
+            return { os, shell: 'bash' };
+        if (process.env.PSModulePath)
+            return { os, shell: 'powershell' };
+        const comspec = (process.env.ComSpec ?? '').toLowerCase();
+        if (comspec.includes('cmd'))
+            return { os, shell: 'cmd' };
+        return { os, shell: 'powershell' };
+    }
+    const s = process.env.SHELL ?? '/bin/bash';
+    if (s.includes('zsh'))
+        return { os, shell: 'zsh' };
+    if (s.includes('fish'))
+        return { os, shell: 'fish' };
+    if (s.includes('pwsh') || s.includes('powershell'))
+        return { os, shell: 'powershell' };
+    return { os, shell: 'bash' };
+}

package/package.json

@@ -1,56 +1,57 @@
-{
-  "name": "@devkitvault/recall",
-  "version": "1.0.5",
-  "description": "recall CLI — cloud-synced command vault (JavaScript build for npm; no bundled native binary)",
-  "keywords": [
-    "cli",
-    "shell",
-    "commands",
-    "devtools",
-    "recall",
-    "vault",
-    "sync",
-    "kubernetes",
-    "docker",
-    "terminal",
-    "devkitvault"
-  ],
-  "author": "devkitvault",
-  "license": "MIT",
-  "homepage": "https://recall.devkitvault.com",
-  "bugs": {
-    "url": "https://github.com/devkitvault/recall/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/devkitvault/recall.git",
-    "directory": "packages/npm-cli"
-  },
-  "bin": {
-    "recall": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "prepublishOnly": "node scripts/prepublish.cjs && node --check dist/index.js",
-    "check:registry": "npm view @devkitvault/recall version",
-    "try:published": "npx --yes --package=@devkitvault/recall@latest recall --version"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "cli-table3": "^0.6.3",
-    "commander": "^12.0.0",
-    "inquirer": "^8.2.7",
-    "open": "^8.4.2",
-    "ora": "^5.4.1"
-  }
-}
+{
+  "name": "@devkitvault/recall",
+  "version": "1.2.0",
+  "description": "recall CLI — AI terminal copilot with a personal command vault",
+  "keywords": [
+    "cli",
+    "shell",
+    "commands",
+    "devtools",
+    "recall",
+    "vault",
+    "sync",
+    "kubernetes",
+    "docker",
+    "terminal",
+    "devkitvault"
+  ],
+  "author": "devkitvault",
+  "license": "MIT",
+  "homepage": "https://recall.devkitvault.com",
+  "bugs": {
+    "url": "https://github.com/devkitvault/recall/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devkitvault/recall.git",
+    "directory": "packages/npm-cli"
+  },
+    "bin": {
+        "recall": "dist/index.js",
+        "rec": "dist/index.js"
+    },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepublishOnly": "node scripts/prepublish.cjs && node --check dist/index.js",
+    "check:registry": "npm view @devkitvault/recall version",
+    "try:published": "npx --yes --package=@devkitvault/recall@latest recall --version"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.3",
+    "commander": "^12.0.0",
+    "inquirer": "^8.2.7",
+    "open": "^8.4.2",
+    "ora": "^5.4.1"
+  }
+}