{"_id":"@anurudda/gitviz","name":"@anurudda/gitviz","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@anurudda/gitviz","version":"1.0.0","description":"Visualize local git repository history in the browser","type":"module","author":{"name":"TachyonicLabs","url":"Pvt"},"homepage":"https://github.com/anurudda/gitviz#readme","repository":{"type":"git","url":"git+https://github.com/anurudda/gitviz.git"},"bugs":{"url":"https://github.com/anurudda/gitviz/issues"},"publishConfig":{"access":"public"},"bin":{"gitviz":"dist/cli.js"},"scripts":{"build":"node esbuild.config.js","dev":"node esbuild.config.js --watch","prepublishOnly":"npm run build","test":"node --import tsx --test src/**/*.test.ts"},"engines":{"node":">=18"},"keywords":["git","visualization","cli","insights","commits","analytics"],"license":"MIT","dependencies":{"commander":"^13.1.0","open":"^10.1.0","simple-git":"^3.27.0"},"devDependencies":{"@types/node":"^22.0.0","chart.js":"^4.4.0","esbuild":"^0.24.0","tsx":"^4.19.0","typescript":"^5.7.0"},"gitHead":"9c97b7a55503fa274c4958a6d26b7050987945f3","_id":"@anurudda/gitviz@1.0.0","_nodeVersion":"25.6.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-gjL9HgRuaWoWU4bVy/qf3g9bzxqhFmBMcE/5eP0+9/3SQFxSXRVAelMYyc3q2l5hSqA7sK0oHrYki255zJCwJg==","shasum":"821a5da6af78a49b755919f47a27c188bb189644","tarball":"https://registry.npmjs.org/@anurudda/gitviz/-/gitviz-1.0.0.tgz","fileCount":6,"unpackedSize":268078,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDKDbe3yStTTpzjU5vHh/h7XXpOMoPuzc6Yc7r2iIk1HAiEAzws8B60bbLp91B+T1NHdBcNlauGc3hw2UzBAULeg5mE="}]},"_npmUser":{"name":"anurudda","email":"anurudda@gmail.com"},"directories":{},"maintainers":[{"name":"anurudda","email":"anurudda@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gitviz_1.0.0_1784045150626_0.039775547735043215"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-14T16:05:50.379Z","1.0.0":"2026-07-14T16:05:50.812Z","modified":"2026-07-14T16:05:51.225Z"},"maintainers":[{"name":"anurudda","email":"anurudda@gmail.com"}],"description":"Visualize local git repository history in the browser","homepage":"https://github.com/anurudda/gitviz#readme","keywords":["git","visualization","cli","insights","commits","analytics"],"repository":{"type":"git","url":"git+https://github.com/anurudda/gitviz.git"},"author":{"name":"TachyonicLabs","url":"Pvt"},"bugs":{"url":"https://github.com/anurudda/gitviz/issues"},"license":"MIT","readme":"# gitviz\n\n> Visualize your local git repository history in the browser — one command, zero config.\n\n`gitviz` scans any local git repository and opens an interactive dashboard in your browser: commit activity, contributor stats, file churn, code frequency, commit-time heatmaps, branch topology, and more. Everything runs locally — your code and history never leave your machine.\n\n## Install\n\n```bash\nnpm install -g @anurudda/gitviz\n```\n\nOr run it without installing:\n\n```bash\nnpx @anurudda/gitviz\n```\n\nRequires **Node.js 18+**.\n\n## Usage\n\nFrom inside any git repository:\n\n```bash\ngitviz\n```\n\nThis scans the repo, starts a local server, and opens the dashboard in your browser. That's it.\n\n### Commands\n\n| Command | Description |\n|---------|-------------|\n| `gitviz` (or `gitviz show`) | Scan the repo and open the visualization in your browser |\n| `gitviz scan` | Force a re-scan and update the cache without opening the browser |\n| `gitviz clean` | Remove the `.gitviz` cache directory |\n\n### Options (for `show`)\n\n| Option | Default | Description |\n|--------|---------|-------------|\n| `-p, --port <number>` | `4873` | Port for the local HTTP server |\n| `-f, --force` | `false` | Force a full re-scan even if the cache is fresh |\n\n```bash\ngitviz --port 8080        # run on a custom port\ngitviz --force            # ignore the cache and re-scan\n```\n\n## What you get\n\nThe dashboard includes:\n\n- **Repository pulse** — high-level summary of the repo's activity\n- **Commits per week** — commit volume over time\n- **Contributors** — per-author commit counts and activity timelines\n- **File churn** — the most-changed files in the repo\n- **Code frequency** — additions vs. deletions per week\n- **Lines of code over time** — codebase size trend\n- **Commit patterns** — activity by hour of day and day of week\n- **Commit heatmap** — a calendar-style view of daily activity\n- **Branch topology** — branches and merge relationships\n\n## Caching\n\nOn first run, `gitviz` scans your full history and caches the result in a `.gitviz/` directory inside your repo. Subsequent runs are near-instant and only pick up new commits. To exclude the cache from version control, add it to your `.gitignore`:\n\n```\n.gitviz/\n```\n\n`gitviz` will remind you to do this if it isn't already ignored. Run `gitviz clean` to remove the cache entirely.\n\n## Privacy\n\n`gitviz` is fully local. It reads your git history, serves the dashboard from `127.0.0.1`, and makes no network requests. Nothing is uploaded anywhere.\n\n## License\n\n[MIT](./LICENSE) © TachyonicLabs (Pvt) Ltd\n","readmeFilename":"README.md","_rev":"1-9e236d4f0e05223134074d91109f7fd6"}