CodeKami

Turn your coding journey into a local anime-inspired RPG — directly inside VS Code.

Pick an original archetype, earn XP as you code, level up, build a daily streak, unlock achievements, track real coding sessions, and watch a companion react to your builds, tests, and commits. CodeKami is offline-first and privacy-first: no backend, no database, no account, and no telemetry. Everything is stored locally in VS Code's own extension storage.

Screenshots

Status bar	Dashboard	Analytics

Features

• Character classes — choose from 8 original, anime-inspired archetypes (Samurai, Ninja, Mage, Cyber Warrior, Dragon Warrior, Alchemist, Pirate, Demon Hunter), each with its own signature weapon.
• XP & Levels — earn XP by starting a coding session and saving files (debounced, so spamming save doesn't farm XP). Level up with a configurable growth curve and titles from Beginner to Legend.
• Daily streaks — a coding streak tracked by your local calendar date, with milestone celebrations at 3, 7, 14, 30, 50, 100, and 365 days.
• Achievements — 15 original achievements spanning level milestones (Apprentice Warrior through Legendary Developer), streak milestones (No Surrender, Centurion, Unbreakable), coding milestones (Ship It, Test Pilot, Committed), and recovery milestones (Redemption Arc, Bug Slayer — bouncing back from a failed build or test), each with bonus XP.
• Anime reactions — a short original message every time you level up, unlock an achievement, build, test, commit, or finish a long session. Every qualifying event reacts, every time — there's no cooldown.
• Terminal companion — an emoji-based companion in your status bar that reacts to the same events, every time, plus a mention on the dashboard. 6 companions to unlock as you level up: Cyber Fox (Lv.1), Shadow Cat (Lv.5), Cyber Slime (Lv.10), Spirit Dragon (Lv.25), Zen Panda (Lv.50), and Astral Spirit (Lv.75).
• Coding sessions — a session starts when you get to work and ends after a period of inactivity. Tracks duration, files touched, build/test results, and commits, with a summary shown when it ends, and a welcome message (with your Developer Card name, if set) when it starts. Build/test detection works for both tasks.json-defined tasks and commands you run directly in a terminal.
• Local analytics — today's, this week's, and this month's coding time, sessions, builds, tests, commits, XP, and achievements, plus a 14-day activity chart — all computed on your machine.
• Custom themes — 6 original color themes for the CodeKami dashboard and panels (Default Cyber, Samurai Dojo, Void Realm, Demon Realm, Neon City, Spirit Forest), with later ones unlocking as you level up.
• Daily motivation — a short, original motivational line on the dashboard, deterministically chosen for the day (no server, no randomness).
• Focus Mode & Boss Battle — a distraction-free timer (15/25/45/60 minutes) that earns XP per minute focused. Boss Battle is the same timer with a boss to defeat (5 original bosses), with an HP bar that drains as you focus. A live panel and status bar countdown track progress; ending a session early lets you keep the XP earned so far or abandon it for none.
• Daily Quests — 3 quests picked deterministically each day, shown on the dashboard. 5 auto-detect (commit, clean build, passing tests, 30 minutes coding, finishing a Focus/Boss session); 2 are marked complete by hand and clearly labeled as manual.
• Export / Import Progress — back up your progress to a JSON file and restore it later, or move it to another machine.
• Quiet Mode / Work Mode — one command to silence notifications, reactions, and session summaries for meetings or screen-sharing; Work Mode also hides the companion and daily motivation. XP and progress keep tracking normally either way.
• Dashboard — a clean Webview panel bringing your character, XP, streak, achievements, companion, theme, and daily motivation together in one place.
• Status bar — a live, at-a-glance summary (⚔️ Lv.12 | 🔥 5 | 840 XP) that opens the dashboard on click.
• Developer Card — generate a shareable, local text card summarizing your progress, auto-copied to your clipboard.
• CodeKami Dark theme — an original dark editor color theme with anime-inspired accents, built for readability (separate from the dashboard themes above).

Commands

Installation

Requires VS Code 1.93 or newer (for Terminal Shell Integration support). Install CodeKami from the VS Code Marketplace by searching for it in the Extensions view, or via the command line:

code --install-extension gouselabs.codekami

Settings

Configure CodeKami under Preferences: Open Settings → search "CodeKami":

Progress

• codekami.sessionStartXp — XP awarded when a coding session starts
• codekami.fileSaveXp — XP awarded per file save
• codekami.fileSaveCooldownSeconds — minimum time between file-save XP rewards, per file
• codekami.sessionInactivityMinutes — minutes of inactivity before a coding session is considered ended

Notifications & reactions

• codekami.enableNotifications — streak milestone and session-start notifications (default: on)
• codekami.showReactions — anime-style reactions for level-ups, achievements, builds, tests, commits, sessions — every qualifying event reacts, every time (default: on)
• codekami.reactionMode — notification, statusBar, or both
• codekami.showSessionSummary — show a summary notification when a session ends (default: on)
• codekami.showCompanion — show the companion in the status bar (default: on)
• codekami.showDailyMotivation — show the daily motivational line on the dashboard (default: on)

Focus

• codekami.focusXpPerMinute — XP earned per minute spent in a Focus Mode or Boss Battle session (default: 3). No XP is earned if a session is abandoned.

Other

• codekami.debugMode — log activity to the "CodeKami" output channel (no source code or file names, ever)

Privacy

CodeKami never reads your source code, environment variables, credentials, or terminal output, and never makes any network request. There is no backend, no database, and no account — your progress lives entirely in VS Code's local extension storage on your machine. Build/test detection uses only the official VS Code Tasks API and Terminal Shell Integration API (the command line and exit code only — never terminal output); commit detection uses the built-in Git extension when available and silently does nothing if it isn't.

Data durability: since everything is local-only by design, use CodeKami: Export Progress to back up your progress to a JSON file. If VS Code's user data directory is ever wiped (not a normal uninstall/reinstall or auto-update — those are safe) and you don't have a recent export, your CodeKami progress is not recoverable.

Contributing / Building from source

git clone https://github.com/gouselabs/kodekami.git
cd kodekami
npm install
npm run compile

Press F5 in VS Code to launch the Extension Development Host. Useful scripts:

• npm run compile — type-check and build
• npm run watch — rebuild on file changes
• npm test — run the unit test suite
• npm run lint — run ESLint
• npm run vsix — produce an installable .vsix package

License

MIT