@devkitvault/recall 1.2.6 → 1.2.9

package/README.md

@@ -1,8 +1,10 @@
 # @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.
+**recall** is a CLI command vault for your terminal. Save the commands you keep losing, search them, run them by name, and sync when you want cloud backup.
 
-Works with [recall.devkitvault.com](https://recall.devkitvault.com) and the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd).
+Product site and docs: [recall.devkitvault.com](https://recall.devkitvault.com)
+
+Open source: [github.com/devkitvault/recall-cli](https://github.com/devkitvault/recall-cli)
 
 ## Requirements
 
@@ -14,68 +16,60 @@ Works with [recall.devkitvault.com](https://recall.devkitvault.com) and the [VS
 npm install -g @devkitvault/recall
 ```
 
-`rec` is the same command as `recall`.
+`rec` is the same binary as `recall`.
 
 ```sh
 recall --version
 recall doctor
 ```
 
-## Quick start
+## Quick start (local vault)
+
+Free is **fully local** — save / list / search / run on your machine with **no account**. Cloud **sync** and **Ask** are Pro/Team.
 
 ```sh
-recall auth login
-recall "find the 10 biggest files in this directory"
-rec "that docker command from last week"
-recall
+recall save "docker compose up -d" --name docker --tags docker
+recall save --last -n useful -t docker
+recall list
+recall search docker
+recall run docker
 ```
 
-No-args `recall` opens an Ask session (`Recall >`). `/save [name]` stores the last suggestion. `/exit` leaves.
+Commands live in `~/.recall/commands.json`.
+
+`recall save --last` (or `-L`) reads the last line from zsh / bash / PowerShell history. Not supported in Windows `cmd.exe`. On bash, if the command is missing: `history -a && recall save --last`.
 
 ```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 `recall agent` for a generated answer). Copy or save it yourself.
-
-## Four launch demos
-
-Ask prints. It does not run.
-
-**`rec "start the project"`** (`source: project`)
+Local playbooks follow the same idea when available; cloud playbooks need Pro. `recall playbook run` executes steps. Ask never does.
 
-![rec start the project](https://recall.devkitvault.com/og/ask-start.gif)
+## Ask (Pro / Team)
 
-**`rec "start postgres and run migrations"`** (`source: vault`)
-
-![rec start postgres and run migrations](https://recall.devkitvault.com/og/ask-playbook.gif)
-
-**`rec "free the process using port 3000"`** (`source: recall agent`)
-
-![rec free the process using port 3000](https://recall.devkitvault.com/og/ask-port.gif)
-
-**`rec "that docker command from last week"`** (`source: vault`)
-
-![rec that docker command from last week](https://recall.devkitvault.com/og/ask-vault.gif)
+Natural-language Ask prints a suggestion and never runs it. Requires a Pro or Team plan.
 
 ```sh
-recall save "docker compose up -d" --name docker --tags docker
-recall run docker
+recall auth login
+recall "find the 10 biggest files in this directory"
+rec "that docker command from last week"
 ```
 
-Run `recall --help` for the full command list. Free plans include **20 AI asks / month**; Pro includes **500**.
+No-args `recall` opens an Ask session (`Recall >`). `/save [name]` stores the last suggestion. `/exit` leaves.
+
+## Auth & sync (Pro / Team)
 
-## Authentication
+Account + Pro/Team syncs your **local** commands to the cloud and unlocks Ask.
 
 ```sh
 recall auth login
-recall auth logout
+recall sync          # pull then push
+recall sync --pull   # cloud → local
+recall sync --push   # local-only → cloud
+recall sync --status
 recall whoami
 ```
-
 ## Prefer a standalone binary?
 
 - **macOS / Linux:** `curl -fsSL https://devkitvault.com/recall/install.sh | sh`
@@ -96,17 +90,18 @@ 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).
+If something still fails, open an issue on [GitHub](https://github.com/devkitvault/recall-cli/issues) or visit [recall.devkitvault.com](https://recall.devkitvault.com).
 
 ## Links
 
 |           |                                                                                           |
 | --------- | ----------------------------------------------------------------------------------------- |
-| Website   | [devkitvault.com/recall](https://devkitvault.com)                                         |
+| Website   | [recall.devkitvault.com](https://recall.devkitvault.com)                                  |
 | Docs      | [recall.devkitvault.com/docs](https://recall.devkitvault.com/docs)                        |
 | Dashboard | [recall.devkitvault.com](https://recall.devkitvault.com)                                  |
+| Source    | [github.com/devkitvault/recall-cli](https://github.com/devkitvault/recall-cli)            |
 | VS Code   | [Marketplace](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd) |
-| Issues    | [github.com/devkitvault/recall](https://github.com/devkitvault/recall/issues)             |
+| Issues    | [github.com/devkitvault/recall-cli](https://github.com/devkitvault/recall-cli/issues)     |
 
 ## License
 

package/dist/commands/ask.js

@@ -15,6 +15,7 @@ const commander_1 = require("commander");
 const inquirer_1 = __importDefault(require("inquirer"));
 const api_1 = require("../lib/api");
 const auth_1 = require("../lib/auth");
+const local_vault_1 = require("../lib/local-vault");
 const events_1 = require("../lib/events");
 const project_1 = require("../lib/project");
 const runtime_1 = require("../lib/runtime");
@@ -91,11 +92,23 @@ async function promptSaveMeta(existingName) {
     };
 }
 async function saveSuggestion(token, command, name, source, risk, tags) {
-    await api_1.ApiClient.post('/commands', {
+    const local = (0, local_vault_1.saveLocalCommand)({
         command,
         name: name?.trim() || undefined,
         tags,
-    }, token);
+    });
+    try {
+        const saved = await api_1.ApiClient.post('/commands', {
+            command,
+            name: name?.trim() || undefined,
+            tags,
+        }, token);
+        if (saved?.id)
+            (0, local_vault_1.attachCloudId)(local.id, saved.id);
+    }
+    catch {
+        // Local save succeeded; cloud may require Pro
+    }
     await (0, events_1.track)('ai_accepted', { source, risk, saved: true });
     console.log(chalk_1.default.green(`\n  ${(0, tags_1.formatSavedMessage)(name, tags)}\n`));
 }

package/dist/commands/delete.js

@@ -7,38 +7,27 @@ exports.deleteCommand = void 0;
 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 local_vault_1 = require("../lib/local-vault");
 exports.deleteCommand = new commander_1.Command('delete')
-    .description('Delete a saved command by name')
+    .description('Delete a command from your local vault')
     .argument('<name>', 'Command name to delete')
     .option('-f, --force', 'Skip confirmation prompt')
     .action(async (name, opts) => {
-    const token = await (0, auth_1.requireAuth)();
-    // First look up the command to confirm it exists
-    const spinner = (0, ora_1.default)('Looking up...').start();
-    let cmd;
-    try {
-        cmd = await api_1.ApiClient.get(`/commands/by-name/${encodeURIComponent(name)}`, token);
-        spinner.stop();
-    }
-    catch {
-        spinner.fail(chalk_1.default.red(`Command "${name}" not found`));
+    const cmd = (0, local_vault_1.findLocalByName)(name);
+    if (!cmd) {
+        console.log(chalk_1.default.red(`\n  Command "${name}" not found in local vault.\n`));
         process.exit(1);
     }
-    // Show what will be deleted
     console.log();
     console.log(`  ${chalk_1.default.dim('Name:')}    ${chalk_1.default.white(cmd.name ?? '—')}`);
     console.log(`  ${chalk_1.default.dim('Command:')} ${chalk_1.default.white(cmd.command)}`);
     console.log();
-    // Confirm unless --force
     if (!opts.force) {
         const { confirm } = await inquirer_1.default.prompt([
             {
                 type: 'confirm',
                 name: 'confirm',
-                message: chalk_1.default.red(`Delete "${name}"?`),
+                message: chalk_1.default.red(`Delete "${name}" from local vault?`),
                 default: false,
             },
         ]);
@@ -47,12 +36,7 @@ exports.deleteCommand = new commander_1.Command('delete')
             return;
         }
     }
-    const deleteSpinner = (0, ora_1.default)('Deleting...').start();
-    try {
-        await api_1.ApiClient.delete(`/commands/${cmd.id}`, token);
-        deleteSpinner.succeed(chalk_1.default.green(`Deleted "${name}"`));
-    }
-    catch {
-        deleteSpinner.fail(chalk_1.default.red('Failed to delete'));
-    }
+    (0, local_vault_1.deleteLocalByName)(name);
+    console.log(chalk_1.default.green(`  Deleted "${name}" from local vault.\n`));
+    console.log(chalk_1.default.dim('  Cloud copy (if any) is unchanged until you sync.\n'));
 });

package/dist/commands/list.js

@@ -7,63 +7,44 @@ exports.listCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const cli_table3_1 = __importDefault(require("cli-table3"));
 const commander_1 = require("commander");
-const ora_1 = __importDefault(require("ora"));
-const api_1 = require("../lib/api");
-const auth_1 = require("../lib/auth");
+const local_vault_1 = require("../lib/local-vault");
 exports.listCommand = new commander_1.Command('list')
-    .description('List your saved commands')
+    .description('List commands in your local vault')
     .option('-t, --tag <tag>', 'Filter by tag')
-    .option('-g, --group <group>', 'Filter by group (Pro)')
+    .option('-g, --group <group>', 'Filter by group (Pro cloud — not used locally)')
     .option('-s, --search <q>', 'Search by keyword')
     .option('-p, --pinned', 'Show pinned only')
     .action(async (opts) => {
-    const token = await (0, auth_1.requireAuth)();
-    const spinner = (0, ora_1.default)('Fetching...').start();
-    try {
-        const params = new URLSearchParams();
-        if (opts.tag)
-            params.set('tag', opts.tag);
-        if (opts.group)
-            params.set('group', opts.group);
-        if (opts.search)
-            params.set('search', opts.search);
-        const { commands } = await api_1.ApiClient.get(`/commands?${params}`, token);
-        spinner.stop();
-        let result = commands;
-        // Filter pinned only
-        if (opts.pinned)
-            result = result.filter((c) => c.pinned);
-        // Sort: pinned first, then by createdAt
-        result.sort((a, b) => {
-            if (a.pinned && !b.pinned)
-                return -1;
-            if (!a.pinned && b.pinned)
-                return 1;
-            return 0;
-        });
-        if (!result.length) {
-            console.log(chalk_1.default.dim('\n  No commands found.\n'));
-            return;
-        }
-        const table = new cli_table3_1.default({
-            head: [chalk_1.default.cyan('Pin'), chalk_1.default.cyan('Name'), chalk_1.default.cyan('Command'), chalk_1.default.cyan('Tags')],
-            style: { head: [], border: ['grey'] },
-            colWidths: [5, 18, 44, 18],
-            wordWrap: true,
-        });
-        for (const cmd of result) {
-            table.push([
-                cmd.pinned ? chalk_1.default.yellow('★') : chalk_1.default.dim('·'),
-                cmd.name ?? chalk_1.default.dim('—'),
-                cmd.command.length > 42
-                    ? cmd.command.slice(0, 42) + '…'
-                    : cmd.command,
-                (cmd.tags ?? []).join(', ') || chalk_1.default.dim('—'),
-            ]);
-        }
-        console.log(table.toString());
+    if (opts.group) {
+        console.log(chalk_1.default.dim('  Local vault has no groups. Showing all local commands.\n'));
     }
-    catch {
-        spinner.fail(chalk_1.default.red('Failed to fetch commands'));
+    const result = (0, local_vault_1.listLocalCommands)({
+        tag: opts.tag,
+        search: opts.search,
+        pinned: opts.pinned,
+    });
+    if (!result.length) {
+        console.log(chalk_1.default.dim('\n  No commands in local vault.'));
+        console.log(chalk_1.default.dim(`  Save one: recall save "echo hi" -n hi`));
+        console.log(chalk_1.default.dim(`  File: ${local_vault_1.VAULT_FILE}\n`));
+        return;
     }
+    const table = new cli_table3_1.default({
+        head: [chalk_1.default.cyan('Pin'), chalk_1.default.cyan('Name'), chalk_1.default.cyan('Command'), chalk_1.default.cyan('Tags')],
+        style: { head: [], border: ['grey'] },
+        colWidths: [5, 18, 44, 18],
+        wordWrap: true,
+    });
+    for (const cmd of result) {
+        table.push([
+            cmd.pinned ? chalk_1.default.yellow('★') : chalk_1.default.dim('·'),
+            cmd.name ?? chalk_1.default.dim('—'),
+            cmd.command.length > 42
+                ? cmd.command.slice(0, 42) + '…'
+                : cmd.command,
+            (cmd.tags ?? []).join(', ') || chalk_1.default.dim('—'),
+        ]);
+    }
+    console.log(table.toString());
+    console.log(chalk_1.default.dim(`\n  ${result.length} local · ${local_vault_1.VAULT_FILE}\n`));
 });

package/dist/commands/pin.js

@@ -6,25 +6,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pinCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
-const ora_1 = __importDefault(require("ora"));
-const api_1 = require("../lib/api");
-const auth_1 = require("../lib/auth");
+const local_vault_1 = require("../lib/local-vault");
 exports.pinCommand = new commander_1.Command('pin')
-    .description('Pin or unpin a command to the top of your list')
+    .description('Pin or unpin a local command')
     .argument('<name>', 'Command name')
     .option('-u, --unpin', 'Unpin instead of pin')
     .action(async (name, opts) => {
-    const token = await (0, auth_1.requireAuth)();
-    const spinner = (0, ora_1.default)('Looking up...').start();
-    try {
-        const cmd = await api_1.ApiClient.get(`/commands/by-name/${encodeURIComponent(name)}`, token);
-        const pinned = !opts.unpin;
-        await api_1.ApiClient.patch(`/commands/${cmd.id}/pin`, { pinned }, token);
-        spinner.succeed(pinned
-            ? chalk_1.default.green(`Pinned "${name}" — it will appear at the top of recall list`)
-            : chalk_1.default.green(`Unpinned "${name}"`));
-    }
-    catch {
-        spinner.fail(chalk_1.default.red(`Command "${name}" not found`));
+    const pinned = !opts.unpin;
+    const cmd = (0, local_vault_1.setLocalPinned)(name, pinned);
+    if (!cmd) {
+        console.log(chalk_1.default.red(`\n  Command "${name}" not found in local vault.\n`));
+        process.exit(1);
     }
+    console.log(pinned
+        ? chalk_1.default.green(`  Pinned "${name}" — it will appear at the top of recall list\n`)
+        : chalk_1.default.green(`  Unpinned "${name}"\n`));
 });

package/dist/commands/run.js

@@ -8,48 +8,34 @@ const chalk_1 = __importDefault(require("chalk"));
 const child_process_1 = require("child_process");
 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 local_vault_1 = require("../lib/local-vault");
 exports.runCommand = new commander_1.Command('run')
-    .description('Run a saved command by name or alias')
-    .argument('<name>', 'Command name or alias')
+    .description('Run a saved local command by name')
+    .argument('<name>', 'Command name')
     .option('-d, --dry-run', 'Print command without running it')
     .option('-c, --confirm', 'Ask for confirmation before running')
     .action(async (name, opts) => {
-    const token = await (0, auth_1.requireAuth)();
-    const spinner = (0, ora_1.default)('Looking up...').start();
-    try {
-        // Try by name first, then alias
-        let cmd;
-        try {
-            cmd = await api_1.ApiClient.get(`/commands/by-name/${encodeURIComponent(name)}`, token);
-        }
-        catch {
-            cmd = await api_1.ApiClient.get(`/aliases/${encodeURIComponent(name)}/resolve`, token);
-        }
-        spinner.stop();
-        console.log(chalk_1.default.dim(`\n  $ ${cmd.command}\n`));
-        if (opts.dryRun)
+    const cmd = (0, local_vault_1.findLocalByName)(name);
+    if (!cmd) {
+        console.log(chalk_1.default.red(`\n  Command "${name}" not found in local vault.\n`));
+        console.log(chalk_1.default.dim('  List: recall list'));
+        console.log(chalk_1.default.dim('  Sync from cloud (Pro): recall sync\n'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.dim(`\n  $ ${cmd.command}\n`));
+    if (opts.dryRun)
+        return;
+    if (opts.confirm) {
+        const { ok } = await inquirer_1.default.prompt([{
+                type: 'confirm',
+                name: 'ok',
+                message: 'Run this command?',
+                default: true,
+            }]);
+        if (!ok) {
+            console.log(chalk_1.default.dim('  Cancelled.\n'));
             return;
-        // Confirm if --confirm flag or command has confirm flag
-        if (opts.confirm) {
-            const { ok } = await inquirer_1.default.prompt([{
-                    type: 'confirm',
-                    name: 'ok',
-                    message: 'Run this command?',
-                    default: true,
-                }]);
-            if (!ok) {
-                console.log(chalk_1.default.dim('  Cancelled.\n'));
-                return;
-            }
         }
-        // Log the run
-        api_1.ApiClient.post(`/commands/${cmd.id}/run`, {}, token).catch(() => { });
-        (0, child_process_1.execSync)(cmd.command, { stdio: 'inherit' });
-    }
-    catch {
-        spinner.fail(chalk_1.default.red(`Command "${name}" not found`));
     }
+    (0, child_process_1.execSync)(cmd.command, { stdio: 'inherit' });
 });

package/dist/commands/save.js

@@ -6,68 +6,65 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.saveCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
-const ora_1 = __importDefault(require("ora"));
-const api_1 = require("../lib/api");
-const auth_1 = require("../lib/auth");
+const shell_history_1 = require("../lib/shell-history");
+const tags_1 = require("../lib/tags");
+const local_vault_1 = require("../lib/local-vault");
 exports.saveCommand = new commander_1.Command('save')
-    .description('Save a command to your vault')
-    .argument('<command>', 'The shell command to save')
+    .description('Save a command to your local vault (no account required)')
+    .argument('[command]', 'The shell command to save (omit when using --last)')
+    .option('-L, --last', 'Save the last command from your shell history')
     .option('-n, --name <name>', 'Short memorable name')
     .option('-t, --tags <tags>', 'Comma-separated tags')
-    .option('-g, --group <group>', 'Save directly to a group (Pro)')
-    .action(async (command, opts) => {
-    const token = await (0, auth_1.requireAuth)();
-    let groupId;
-    // Resolve group name to ID if provided
-    if (opts.group) {
-        const spinner = (0, ora_1.default)(`Looking up group "${opts.group}"...`).start();
+    .option('-g, --group <group>', 'Group (Pro / cloud — ignored for local save)')
+    .addHelpText('after', `
+Examples:
+  $ recall save "docker compose up -d" -n start-stack -t docker
+  $ recall save --last
+  $ recall save --last -n start-stack -t docker
+
+  Saves to the local vault (~/.recall/commands.json). No login required.
+  Sync to the cloud with Pro: recall auth login && recall sync
+
+  --last reads zsh/bash/PowerShell history (not cmd.exe).
+  Bash tip: if the command is missing, run: history -a && recall save --last
+`)
+    .action(async (commandArg, opts) => {
+    let command = commandArg?.trim();
+    if (opts.last) {
+        if (command) {
+            console.log(chalk_1.default.yellow('  Ignoring the command argument because --last was set.'));
+        }
         try {
-            const group = await api_1.ApiClient.get(`/groups/by-name/${encodeURIComponent(opts.group)}`, token);
-            groupId = group.id;
-            spinner.stop();
+            const last = (0, shell_history_1.getLastShellCommand)();
+            command = last.command;
+            console.log(chalk_1.default.dim(`  From ${last.shell} history: ${command}`));
         }
         catch (err) {
-            if (err instanceof api_1.ApiError && err.status === 403) {
-                spinner.stop();
-                console.log(chalk_1.default.yellow('\n  Groups require a Pro plan.'));
-                console.log(chalk_1.default.dim('  Run: recall upgrade\n'));
-                process.exit(1);
-            }
-            if (err instanceof api_1.ApiError && err.status === 404) {
-                // Auto-create the group
-                spinner.text = `Creating group "${opts.group}"...`;
-                try {
-                    const newGroup = await api_1.ApiClient.post('/groups', { name: opts.group }, token);
-                    groupId = newGroup.id;
-                    spinner.succeed(chalk_1.default.green(`Created group "${opts.group}"`));
-                }
-                catch (createErr) {
-                    spinner.fail(chalk_1.default.red(`Failed to create group "${opts.group}"`));
-                    process.exit(1);
-                }
-            }
-            else {
-                spinner.fail(chalk_1.default.red(`Failed to look up group "${opts.group}"`));
+            if (err instanceof shell_history_1.LastCommandError) {
+                console.log(chalk_1.default.red(`\n  ${err.message}\n`));
                 process.exit(1);
             }
+            throw err;
         }
     }
-    const spinner = (0, ora_1.default)('Saving...').start();
-    try {
-        const saved = await api_1.ApiClient.post('/commands', {
-            command,
-            name: opts.name,
-            tags: opts.tags?.split(',').map((t) => t.trim()),
-            groupId,
-        }, token);
-        spinner.succeed(chalk_1.default.green(`Saved${saved.name ? ` as "${saved.name}"` : ''}` +
-            (opts.group ? chalk_1.default.dim(` → group "${opts.group}"`) : '')));
+    if (!command) {
+        console.log(chalk_1.default.red('\n  Provide a command, or use --last to take it from shell history.\n'));
+        console.log(chalk_1.default.dim('  Examples:'));
+        console.log(chalk_1.default.dim('    recall save "docker compose up -d"'));
+        console.log(chalk_1.default.dim('    recall save --last\n'));
+        process.exit(1);
     }
-    catch (err) {
-        spinner.fail(chalk_1.default.red('Failed to save'));
-        if (err instanceof api_1.ApiError && err.status === 403 && err.body?.upgrade) {
-            console.log(chalk_1.default.yellow('\n  This feature requires an upgrade.'));
-            console.log(chalk_1.default.dim(`  Upgrade at ${chalk_1.default.white(err.body.upgrade)}\n`));
-        }
+    if (opts.group) {
+        console.log(chalk_1.default.yellow('  Groups sync with Pro cloud vault. Saved locally without a group.'));
+        console.log(chalk_1.default.dim('  After upgrading: recall sync\n'));
     }
+    const tags = (0, tags_1.parseTags)(opts.tags);
+    const saved = (0, local_vault_1.saveLocalCommand)({
+        command,
+        name: opts.name,
+        tags,
+    });
+    console.log(chalk_1.default.green(`  Saved locally${saved.name ? ` as "${saved.name}"` : ''}`));
+    console.log(chalk_1.default.dim(`  Vault: ${local_vault_1.VAULT_FILE}`));
+    console.log(chalk_1.default.dim('  Sync to cloud (Pro): recall sync\n'));
 });