huntr-cli 1.0.9 → 1.2.0

package/README.md

@@ -14,6 +14,7 @@ A command-line interface for managing your Huntr job search board. Track activit
 - 🎯 **Your board only** — Personal user API (not organization-scoped)
 - 🔒 **Secure storage** — Session data stored in macOS Keychain
 - ⚡ **Fast** — No copy-paste token juggling, session persists for weeks
+- 🐚 **Shell completions** — Tab completion for bash, zsh, and fish
 
 ## Installation
 
@@ -116,7 +117,17 @@ Then use the CLI:
 huntr activities list <board-id>
 ```
 
-The CLI automatically loads `.env` without any special flags. **Note:** Keep `.env` out of version control (add to `.gitignore`).
+By default, the CLI does NOT auto-load `.env` to avoid noisy logs. To load it, prefix commands with `HUNTR_LOAD_ENV=true`.
+
+Examples:
+
+```bash
+HUNTR_LOAD_ENV=true huntr activities list <board-id>
+# or in dev:
+HUNTR_LOAD_ENV=true npm run dev -- boards list
+```
+
+**Note:** Keep `.env` out of version control (it's already in `.gitignore`).
 
 To get your token, log into Huntr and run in your browser DevTools console:
 
@@ -232,6 +243,28 @@ Export last 7 days as CSV:
 huntr activities week-csv <board-id> > activities.csv
 ```
 
+### Shell Completions
+
+Generate and install tab completion for your shell:
+
+```bash
+# bash — add to ~/.bash_completion or source from ~/.bashrc
+huntr completions bash >> ~/.bash_completion
+source ~/.bash_completion
+
+# zsh — save to a completions directory in your fpath
+mkdir -p ~/.zsh/completions
+huntr completions zsh > ~/.zsh/completions/_huntr
+# Add to ~/.zshrc if not already present:
+#   fpath=(~/.zsh/completions $fpath)
+#   autoload -Uz compinit && compinit
+
+# fish
+huntr completions fish > ~/.config/fish/completions/huntr.fish
+```
+
+Once installed, tab-completing `huntr <tab>` will show all subcommands, and `huntr config <tab>`, `huntr boards <tab>`, etc. will show their respective subcommands.
+
 ### Global Options
 
 - `-t, --token <token>` — Specify API token (overrides all other sources)

package/build.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { build } from 'esbuild';
+import { rmSync } from 'fs';
+
+// Clean dist directory
+rmSync('dist', { recursive: true, force: true });
+
+// Build CLI with esbuild
+await build({
+  entryPoints: ['src/cli.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'esm',
+  outfile: 'dist/cli.js',
+  packages: 'external', // Don't bundle node_modules
+  sourcemap: true,
+  minify: false,
+}).catch(() => process.exit(1));
+
+console.log('✓ Build complete');