Pika × Char
Made with love for Charlene (Char the Charizard 🔥) by Pushkal (pika pika ⚡).
Captain Pikachu and Charizard live in a small panel beside your code. They wander, react when you hover over them, spar with lightning and fire that turns into a heart, cheer you on, keep time with you, and can show how many tokens your AI coding tools are burning.
Where they live
By default the companions get their own tab in the bottom panel (next to Terminal), so the Explorer stays free for your files. You can change this with pikaXChar.position:
panel: bottom panel (default)
explorer: a short view under your files in the Explorer
You can also drag the view anywhere VS Code allows, including the Secondary Side Bar on the right, which keeps your files and the companions both in view.
Run Pika × Char: Open Companions from the Command Palette (Ctrl+Shift+P) to show them.
Play
- Hover over a companion: it hops and looks happy. Captain Pikachu's cheeks crackle, Charizard puffs embers, and the other one turns to look. Stay a moment and hearts appear.
- Click a companion to pet it; click a sleeping one to wake it.
- Click empty space to throw a ball.
- Right-click a companion (or focus it and press Shift+F10) for: Pet, Berry, Fetch, Friendly spar, Hang out, and Nap.
- Friendly spar: they face off with a Thunderbolt and a Flamethrower, the attacks collide, and the burst turns into a heart. Nobody gets hurt.
- Hang out: every so often they wander over to each other on their own. Turn this off with
pikaXChar.hangOut.
- Size: use Change Size in the view's
… menu, press Ctrl+scroll over the panel, or press +/- while a companion is focused. Sizes are 64, 96 and 128px, always whole-pixel multiples so the art stays sharp.
- The view header has + (add), shuffle and trash (remove).
Motivation
The companions say something encouraging every half hour or so, celebrate focus milestones, and suggest a break after 90 minutes of continuous focus. Add your own lines with pikaXChar.motivation.customMessages, or run Motivate Me when you need one now.
Timers
The status bar shows how long this VS Code window has been open. Hover over it for time focused today and your daily streak, or click it for the full menu.
Start / Stop Focus Timer runs a 15/25/45/60-minute or custom countdown in the status bar. When it ends, the companions celebrate.
AI usage (opt-in)
Run Pika × Char: Choose AI Tools to Track, or click the AI row in the info card, and tick only the tools you use. Untick everything to stop tracking. A second status bar item then shows today's tokens and how much of your tightest limit you've used. Limit bars in the info card fill up as you use them, showing the % used.
| Tool |
What is shown |
Where it comes from |
| Claude Code |
Tokens today (input, output, cache), tokens in the current 5-hour block and when it resets, and a notice if you've hit a limit |
~/.claude/projects/**/*.jsonl (or CLAUDE_CONFIG_DIR) |
| Claude limits (online, opt-in) |
5-hour and weekly limit % used with reset times |
api.anthropic.com, using your Claude Code login (see below) |
| Codex |
Tokens today and this week, plus 5-hour and weekly limit % with reset times |
~/.codex/sessions/** (or CODEX_HOME) |
| Kiro app |
Monthly credits % used (including active bonus credits), your plan and reset date, as of Kiro's last plan check |
Kiro's own log of its usage-limit check: %APPDATA%\Kiro\logs (Windows), ~/Library/Application Support/Kiro/logs (macOS), ~/.config/Kiro/logs (Linux) |
| Kiro CLI |
Credits used today and this month |
~/.kiro/sessions/cli/*.json |
The extension reads only the numbers from these logs, on your machine. Nothing is uploaded.
Claude Code doesn't save how close you are to a limit, so Claude limits is a separate, opt-in choice. When it's ticked, the extension reads your Claude Code login token from ~/.claude/.credentials.json and asks the same endpoint Claude Code's /usage screen uses, at most every 5 minutes. The token goes only to api.anthropic.com and is never stored or logged. That endpoint isn't officially documented, so it could change. If the login has expired, open Claude Code once to refresh it. On macOS, Claude Code keeps the login in the Keychain, so this option can't read it there.
Other gaps:
- The Kiro app only updates its numbers when it's open and checks your plan, so the card shows them "as of" that check. After your monthly reset, it asks you to open Kiro to refresh.
- Kiro's agent runs inside the Kiro app; there's no separate Kiro extension for VS Code to read from.
When Claude, Codex or Kiro passes pikaXChar.usage.warnPercent used (default 80%), the bar and status item turn amber and a companion lets you know.
Settings
| Setting |
Default |
Purpose |
pikaXChar.position |
panel |
panel or explorer |
pikaXChar.size |
medium |
small (64px), medium (96px), large (128px) |
pikaXChar.hangOut |
true |
They occasionally hang out on their own |
pikaXChar.reactToTyping |
true |
Small cheers while you edit (document text is never read) |
pikaXChar.reducedMotion |
false |
Keep still; system reduced motion is also respected |
pikaXChar.motivation.enabled |
true |
Encouraging lines |
pikaXChar.motivation.intervalMinutes |
30 |
How often; 0 turns periodic lines off |
pikaXChar.motivation.customMessages |
[] |
Your own lines |
pikaXChar.breakReminderMinutes |
90 |
Break nudge after continuous focus; 0 turns it off |
pikaXChar.statusBar.timer |
true |
Session timer in the status bar |
pikaXChar.usage.enabled |
false |
AI usage tracking |
pikaXChar.usage.sources |
all |
claude, codex, kiro |
pikaXChar.usage.claudeLimits |
false |
Claude 5-hour and weekly % used (online, see above) |
pikaXChar.showInfo |
true |
Info card with the timer and usage |
pikaXChar.usage.warnPercent |
80 |
Limit warning threshold |
Privacy
There is no account, telemetry or runtime dependency, and no network access unless you turn on Claude limits, which talks only to api.anthropic.com. All images are bundled. Typing reactions only count edit events. Usage tracking is off until you turn it on, and then reads only token counts, credits, limit percentages and timestamps from local log files.
Credits
This is an unofficial fan extension, not affiliated with or endorsed by Nintendo, Game Freak, Creatures or The Pokémon Company. Pokémon and character names are trademarks of their respective owners. The Pikachu and Charizard pixel sprites come from VS Code Pokemon (© The Pokémon Company / Nintendo / Game Freak). Captain Pikachu is that Pikachu sprite with Captain Pikachu's cap painted on. See LICENSE.txt and the CREDITS.txt files in media/.
Develop
Requires Node.js 20+ and VS Code 1.90+.
npm ci
npm test # unit tests: model, host wiring, usage parsing
npm run check # syntax check
npm run preview # browser preview at http://127.0.0.1:4173
npm run test:browser # Playwright checks against the preview (set PIKA_X_CHAR_BROWSER to use local Chrome)
npm run test:host # smoke test inside a real VS Code (downloads it once into .vscode-test/)
npm run package # builds pika-x-char-<version>.vsix
Press F5 in VS Code to launch an Extension Development Host.
src/extension.js: VS Code wiring, timers, status bar and motivation.
src/usage.js: the local log reader.
media/main.js: animation, hover and effects.
media/sprites.js: frames and expressions.
scripts/build-captain.py: draws the cap.
scripts/build-icon.py: builds the Marketplace icon.