Gitquarium 🐟

Your Git history as a living aquarium, right inside VS Code.

Gitquarium turns a repository's commit history into a cosy animated reef. Every commit becomes a fish that is born, swims, ages and finally settles in the sand. It runs in a panel next to your code and updates live as you commit.

Everything stays on your machine — no telemetry, no network, no analytics.

Features

• Commits become fish. Each commit's type, size and time of day decides its species, size and behaviour.
• Live feeding. A new commit sprinkles food and the fish dart over to it.
• Depth & life. Recent commits swim near the glass, older ones recede into a hazy background; fish are curious about your cursor.
• Species to discover — open the 📖 collection panel: | Commit | Fish | |---|---| | feat: | Standard fish (author's color) | | fix: | Nervous fish, zigzagging | | refactor: / huge diff | Whale | | committed 1–5 am | Bioluminescent abyssal fish | | release / version bump | Rare golden fish 👑 | | merge | A little school | | branch unmerged 90+ days | Skeleton on the sand |
• Achievements. Unlock trophies as your aquarium grows (first fish, five species, a release, a 7-day streak, 3+ contributors, 100/500 fish…).
• Force-push tsunami and murky water for long-abandoned repos.
• Four themes (Lagoon, Abyss, Coral reef, Japanese pond) and a calm mode that respects reduced-motion preferences.

Usage

1. Open a folder that is a Git repository.
2. Click the Gitquarium 🐟 icon in the activity bar (left side) — the aquarium shows up as a live preview in the sidebar. Use the ⚙️ button to customize it and the 📖 button to browse species. The title bar opens the full aquarium in the editor; you can also run “Gitquarium: Open the aquarium” from the Command Palette (Ctrl/Cmd+Shift+P).
3. Watch your history swim. Keep coding — new commits feed the fish live.

Customize the shared aquarium (no JSON to write by hand)

Everything is a click — no JSON to edit. Open the ⚙️ panel to:

• Switch theme (Lagoon, Abyss, Coral reef, Japanese pond) and toggle calm mode.
• Add a decoration — a castle, chest, rock, plant or anchor on the sand.

And click any fish to open an inline editor: give it a name and an optional 👑 crown.

Themes and calm mode are personal (saved in your VS Code settings). Decorations and pinned fish are shared: they write a .gitquarium.json at the repo root and offer to commit it, so everyone on the repo sees them on their next pull. No server, no network.

Prefer raw JSON? The ⚙️ panel has an Edit .gitquarium.json button (also the “Gitquarium: Edit the shared aquarium file” command) that opens the file — creating it if needed. ⚠️ It's a shared, committed file: commit and push it so your team sees your changes.

Settings

Personal cosmetics — coming soon

The entire shared aquarium is free. Optional personal cosmetics — like premium fish skins (Neon, Pastel, Sunset, Noir) and particle ambiances — are on their way. When they land, they'll be unlocked by an offline license verified locally on your machine (nothing sent anywhere), and will be personal: only you see them, never committed to the repo. Nothing to buy yet — enjoy the free aquarium in the meantime. ✨

Privacy

Gitquarium reads your local Git history with git log and renders it locally. Nothing is sent anywhere. No telemetry, no network calls.

Development

npm install
npm run build        # tsc (host) + vite (webview bundle)
npm run package      # build a .vsix

Press F5 to launch the Extension Development Host, then run the command from the palette. The aquarium engine and Git parser are shared with the desktop build; the extension host reads the repo and posts ready-made fish to a webview that never touches Git.

License

Proprietary — see LICENSE.txt.