@usagefleet/cli 1.2.71 → 1.2.72

package/README.md

@@ -40,6 +40,14 @@ usagefleet update         # upgrade now (it also self-updates every 6h)
 usagefleet config         # config file location + every env override
 usagefleet install        # (re)install the background service, idempotent
 usagefleet uninstall      # remove it
+usagefleet completion zsh # print a shell completion script (zsh, fish)
+```
+
+Completions are printed, not installed — send them where your shell looks:
+
+```bash
+usagefleet completion zsh  > ~/.zsh/completions/_usagefleet   # a dir on your fpath
+usagefleet completion fish > ~/.config/fish/completions/usagefleet.fish
 ```
 
 ## What it collects

package/dist/completion.js

@@ -0,0 +1,56 @@
+/** The command list, shared by `help` and the generated completion scripts, so
+ *  a new command can't land in one and be missing from the other. `args` is the
+ *  hint `help` prints after the name; completion only needs the bare name. */
+export const commands = [
+    { name: 'run', meaning: 'scan once, upload usage + report limits' },
+    { name: 'watch', args: '[--interval s]', meaning: 'poll continuously (default 15s)' },
+    { name: 'limits', meaning: 'report only your real 5h/weekly usage' },
+    { name: 'guard', meaning: 'exit 2 when the group is over a blocking limit' },
+    { name: 'update', meaning: 'update to the latest release now' },
+    { name: 'notify-test', meaning: 'fire a test desktop notification' },
+    { name: 'status', meaning: 'service health, limits, resolved config' },
+    { name: 'config', meaning: 'config file location and env overrides' },
+    { name: 'completion', args: '<zsh|fish>', meaning: 'print a shell completion script' },
+    { name: 'version', meaning: 'print the release version' },
+    { name: 'install', args: '--token <t>', meaning: 'configure + install the service and prompt guard' },
+    { name: 'uninstall', meaning: 'remove the service and the guard' },
+];
+export const shells = ['zsh', 'fish'];
+/** A completion script for `shell`, on stdout — the user decides where it goes
+ *  (`> ~/.zsh/completions/_usagefleet`, `> ~/.config/fish/completions/…`).
+ *  Writing those files ourselves would mean guessing at fpath and rc files. */
+export function completionScript(shell) {
+    return shell === 'zsh' ? zsh() : fish();
+}
+function zsh() {
+    // zsh splits a _describe entry on the first colon, so any colon in the text
+    // has to be escaped or the description gets cut in half.
+    const rows = commands.map(c => `\t\t'${c.name}:${c.meaning.replaceAll(':', '\\:')}'`).join('\n');
+    return `#compdef usagefleet
+
+_usagefleet() {
+	local -a commands
+	commands=(
+${rows}
+	)
+	if (( CURRENT == 2 )); then
+		_describe 'command' commands
+	elif [[ $words[2] == completion ]]; then
+		_values 'shell' ${shells.join(' ')}
+	fi
+}
+
+_usagefleet "$@"
+`;
+}
+function fish() {
+    const quote = (s) => s.replaceAll("'", "\\'");
+    const rows = commands
+        .map(c => `complete -c usagefleet -n __fish_use_subcommand -a ${c.name} -d '${quote(c.meaning)}'`)
+        .join('\n');
+    // -f: no file completion, this CLI takes no paths.
+    return `complete -c usagefleet -f
+${rows}
+complete -c usagefleet -n '__fish_seen_subcommand_from completion' -a '${shells.join(' ')}'
+`;
+}

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { detectClaudeCreds } from './claude-creds.js';
 import { reportLimitsOnce, runOnce } from './collector.js';
+import { commands, completionScript, shells } from './completion.js';
 import { loadConfig } from './config.js';
 import { runGuard } from './guard.js';
 import { loadNotifyConfig } from './notifier.js';
@@ -248,24 +249,21 @@ function cmdConfig() {
     console.log('');
     console.log(hint('`usagefleet status` shows the resolved values'));
 }
+/** Print a completion script, or the shells we know how to write one for. */
+function cmdCompletion() {
+    const shell = process.argv[3];
+    if (!shells.includes(shell)) {
+        console.error(fail('completion', `expected one of ${shells.join(', ')}`));
+        process.exitCode = 1;
+        return;
+    }
+    console.log(completionScript(shell));
+}
 /** Command list, in the same padded-column style as the result lines. */
 function help() {
-    const commands = [
-        ['run', 'scan once, upload usage + report limits'],
-        ['watch [--interval s]', 'poll continuously (default 15s)'],
-        ['limits', 'report only your real 5h/weekly usage'],
-        ['guard', 'exit 2 when the group is over a blocking limit'],
-        ['update', 'update to the latest release now'],
-        ['notify-test', 'fire a test desktop notification'],
-        ['status', 'service health, limits, resolved config'],
-        ['config', 'config file location and env overrides'],
-        ['version', 'print the release version'],
-        ['install --token <t>', 'configure + install the service and prompt guard'],
-        ['uninstall', 'remove the service and the guard'],
-    ];
     console.log(header());
     console.log('');
-    print(commands);
+    print(commands.map(c => [c.args ? `${c.name} ${c.args}` : c.name, c.meaning]));
     console.log('');
     console.log(hint('`usagefleet config` lists the config file and its env overrides'));
 }
@@ -309,6 +307,9 @@ async function main() {
         case 'config': {
             return cmdConfig();
         }
+        case 'completion': {
+            return cmdCompletion();
+        }
         // Bare version, so the installer can compare builds without parsing help.
         case 'version':
         case '--version':

package/dist/release.js

@@ -1,2 +1,2 @@
 // Generated by .github/workflows/release.yml.
-export const RELEASE_VERSION = "1.2.71";
+export const RELEASE_VERSION = "1.2.72";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@usagefleet/cli",
-	"version": "1.2.71",
+	"version": "1.2.72",
 	"description": "Tails Claude Code, Claude Desktop, and pi agent JSONL logs and reports token usage to a UsageFleet server.",
 	"keywords": [
 		"claude",