{"id":18688,"library":"proj-track","title":"proj-track","description":"Auto-capture CLI command history per-project with zero terminal interference. v2.0.1 — active development. Installs as global CLI tool via npm. Per-project isolation via .proj-track.json, smart filtering of noise/sensitive commands, instant replay by ID. Works with Bash and Zsh using PROMPT_COMMAND/preexec — no DEBUG trap footguns. Ships TypeScript types, requires Node >=18. Lightweight alternative to atuin, bashhub, or manual tracking.","status":"active","version":"2.0.1","language":"javascript","source_language":"en","source_url":"https://github.com/Ali-Raza-Arain/proj-track","tags":["javascript","cli","command-history","project-tracker","terminal","developer-tools","shell-history","bash","zsh","typescript"],"install":[{"cmd":"npm install proj-track","lang":"bash","label":"npm"},{"cmd":"yarn add proj-track","lang":"bash","label":"yarn"},{"cmd":"pnpm add proj-track","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Used for colored CLI output in list and status messages.","package":"chalk","optional":true},{"reason":"CLI command parsing and argument handling.","package":"commander","optional":true}],"imports":[{"note":"ESM-only since v2; no CommonJS module available.","wrong":"const projTrack = require('proj-track')","symbol":"default","correct":"import projTrack from 'proj-track'"},{"note":"Named export for programmatic command tracking; avoid subpath imports.","wrong":"import trackCommand from 'proj-track/trackCommand'","symbol":"trackCommand","correct":"import { trackCommand } from 'proj-track'"},{"note":"initialize is available as named export from main package.","wrong":"const initialize = require('proj-track').initialize","symbol":"initialize","correct":"import { initialize } from 'proj-track'"}],"quickstart":{"code":"cd ~/your-project\nnpm install -g proj-track\nproj-track init\necho 'source ~/.bashrc' >> ~/.bashrc\nsource ~/.bashrc\nls\ndocker-compose up --build\nproj-track list\nproj-track run 1\n","lang":"javascript","description":"Install globally, initialize in project, reload shell, auto-capture commands, list history, re-run by ID."},"warnings":[{"fix":"Use `npm install -g proj-track` and re-run `proj-track init` in each project.","message":"Global install via npm install -g required; local install won't activate shell hooks.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Add `.proj-track.json` to `.gitignore` if sensitive commands are a concern, or rely on smart filtering.","message":".proj-track.json file must be committed or gitignored carefully; contains all commands including sensitive ones filtered by default.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Run `source ~/.bashrc` (or `source ~/.zshrc`) after `proj-track init`.","message":"Shell reload (source ~/.bashrc or ~/.zshrc) required after init; otherwise hooks won't fire.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use `import` syntax or dynamic import: `const projTrack = await import('proj-track')`.","message":"v2.0.0 migrated to ESM-only; CommonJS require() breaks.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Prefix sensitive commands with a space (shell history ignore) or use explicit `# notrack` comment.","message":"Smart filtering may miss environment variable assignments or inline scripts; sensitive data may still be logged.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install -g proj-track` and ensure npm global bin directory is in PATH.","cause":"Package not installed or globally installed but not in PATH.","error":"Error: Cannot find module 'proj-track'"},{"fix":"Run `source ~/.bashrc` or `source ~/.zshrc` after install; add npm global bin to PATH if needed.","cause":"Shell not reloaded after install or npm global bin not in PATH.","error":"bash: proj-track: command not found"},{"fix":"Use `import projTrack from 'proj-track'` (ESM only) or `const projTrack = await import('proj-track')`.","cause":"Using default import with old CommonJS require or wrong import style.","error":"TypeError: projTrack is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}