proj-track

library2.0.1jsnpmunverified

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.

devops

npm install proj-track

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PROJ-TRACK

proj-track

devopsjavascriptv2.0.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import projTrack from 'proj-track'

✗ const projTrack = require('proj-track')

ESM-only since v2; no CommonJS module available.

trackCommand

✓ import { trackCommand } from 'proj-track'

✗ import trackCommand from 'proj-track/trackCommand'

Named export for programmatic command tracking; avoid subpath imports.

initialize

✓ import { initialize } from 'proj-track'

✗ const initialize = require('proj-track').initialize

initialize is available as named export from main package.

Install globally, initialize in project, reload shell, auto-capture commands, list history, re-run by ID.

cd ~/your-project npm install -g proj-track proj-track init echo 'source ~/.bashrc' >> ~/.bashrc source ~/.bashrc ls docker-compose up --build proj-track list proj-track run 1

proj-track --version

Debug

Known issues

gotchaGlobal install via npm install -g required; local install won't activate shell hooks.

fix

Use `npm install -g proj-track` and re-run `proj-track init` in each project.

affects: >=2.0.0

gotcha.proj-track.json file must be committed or gitignored carefully; contains all commands including sensitive ones filtered by default.

fix

Add `.proj-track.json` to `.gitignore` if sensitive commands are a concern, or rely on smart filtering.

affects: >=1.0.0

gotchaShell reload (source ~/.bashrc or ~/.zshrc) required after init; otherwise hooks won't fire.

fix

Run `source ~/.bashrc` (or `source ~/.zshrc`) after `proj-track init`.

affects: >=1.0.0

breakingv2.0.0 migrated to ESM-only; CommonJS require() breaks.

fix

Use `import` syntax or dynamic import: `const projTrack = await import('proj-track')`.

affects: >=2.0.0

gotchaSmart filtering may miss environment variable assignments or inline scripts; sensitive data may still be logged.

fix

Prefix sensitive commands with a space (shell history ignore) or use explicit `# notrack` comment.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'proj-track'

Package not installed or globally installed but not in PATH.

fix

Run `npm install -g proj-track` and ensure npm global bin directory is in PATH.

bash: proj-track: command not found

Shell not reloaded after install or npm global bin not in PATH.

fix

Run `source ~/.bashrc` or `source ~/.zshrc` after install; add npm global bin to PATH if needed.

TypeError: projTrack is not a function

Using default import with old CommonJS require or wrong import style.

fix

Use `import projTrack from 'proj-track'` (ESM only) or `const projTrack = await import('proj-track')`.

Upgrade

Version history

2.0.1latest on npm

Audit

Dependencies

chalkoptionalUsed for colored CLI output in list and status messages.

commanderoptionalCLI command parsing and argument handling.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Ali-Raza-Arain/proj-track ↗

packagehttps://www.npmjs.com/package/proj-track ↗

homepagehttps://Ali-Raza-Arain.github.io/proj-track/ ↗