Tuca RPG
Extensão do VS Code que transforma o uso do Claude Code num personagem de RPG em pixel art. Você trabalha
normalmente; o personagem sobe de nível, ganha magias, ouro e conquistas sozinho, e um salão de castelo no
painel de baixo mostra o herói reagindo ao que o Claude está fazendo.
English below. · Projeto independente, sem vínculo com a Anthropic.
Como funciona
- Nível sobe com o que o Claude faz por você: ação rende pouco, entrega rende muito (commit, envio,
pedido de revisão aceito, rodada de teste passando, publicação) e cada dia de uso também conta.
- Atributos: Força (escrever), Agilidade (comandos), Percepção (ler e pesquisar), Vitalidade (dias de
uso), Vontade (entregas). A classe nasce dos dois traços mais fortes (Duelista, Guardião, Sábio…).
- Magias: cada skill usada vira uma magia; invocações: cada tipo de agente. Sobem de nível com o uso.
- Ouro: 1 moeda a cada 10 pontos, para gastar na loja.
- Conquistas liberam os itens únicos (nome dourado), que entram sozinhos na mochila.
Tudo é calculado a partir dos registros de conversa que o próprio Claude Code grava em ~/.claude/projects.
Nada sai do computador, não há rede nem telemetria, e nenhum texto de conversa é guardado: só contagens.
Idiomas
A extensão fala português quando o VS Code está em português e inglês em qualquer outro idioma
(segue o idioma de exibição do VS Code; trocar exige reiniciar o VS Code). Nomes de skills e de agentes
ficam como são.
Telas
- Rodapé (canto de baixo à direita): nível, barra e ouro. Clique para abrir a ficha. Brilha quando algo
acontece; fica amarelo se a contagem parar (ver "Vigia").
- Ficha: personagem (abas Feitos, Magias, Invocações e Conquistas), figura grande vestindo o que você
equipou, inventário e mochila. Teclas: L loja, M livro de magias, S salão.
- Loja (tecla L): mercador à esquerda, a figura no meio provando o item clicado, inventário à direita.
- Salão: no painel de baixo (aba "Tuca RPG") e no modo Salão da ficha. O herói entra e acena ao abrir,
senta na mesa enquanto o Claude trabalha, conjura quando uma skill é usada, treina quando um agente é
chamado, comemora entregas, brilha no nível novo, vai para a poltrona após 5 min parado e para o trono
após 30 min.
Avisos
Nível novo e conquista aparecem no canto da tela; magia nova e classe nova só fazem o rodapé brilhar.
Com várias janelas do VS Code abertas, só uma avisa. Mude em tucaRpg.avisos (grandes, todos,
nenhum).
Vigia
Se o Claude Code mudar o jeito de gravar as conversas, o rodapé fica amarelo com "Tuca RPG parou de contar"
em vez de o personagem simplesmente parar de subir. Detalhes em Tuca RPG: Ver registro (aba Saída).
Comandos
Tuca RPG: Abrir ficha
Tuca RPG: Criar personagem — nome, aparência e "do zero" ou "usar o histórico"
Tuca RPG: Trocar início da contagem — do zero ou histórico, sem perder nada
Tuca RPG: Ver registro — o que o jogo leu e os erros
Configurações
| Configuração |
Padrão |
Para quê |
tucaRpg.pastaDados |
pasta da extensão |
onde ficam o diário de contagens, o personagem e o cofre |
tucaRpg.pastaRegistros |
~/.claude/projects |
onde o Claude Code grava as conversas |
tucaRpg.avisos |
grandes |
o que vira aviso no canto da tela |
Licença
Código sob MIT; a arte (herói, salão, ícones, molduras) tem todos os direitos reservados e só pode ser usada
dentro da extensão. Prints e vídeos de uso são livres. Detalhes no arquivo LICENSE. Tuca RPG é um projeto
independente: não é feito nem apoiado pela Anthropic; "Claude" e "Claude Code" são marcas da Anthropic, citadas
só para dizer o que a extensão lê.
Tuca RPG (English)
A VS Code extension that turns your Claude Code usage into a pixel-art RPG character. You work as usual;
the character levels up, learns spells, earns gold and achievements on its own, and a castle hall in the
bottom panel shows the hero reacting to what Claude is doing.
How it works
- Level goes up with what Claude does for you: actions are worth a little, deliveries are worth a lot
(commit, push, accepted review request, passing test run, release) and every day of use counts too.
- Attributes: Strength (writing), Agility (commands), Perception (reading and searching), Vitality
(days of use), Willpower (deliveries). Your class comes from your two strongest traits (Duelist,
Guardian, Sage…).
- Spells: every skill used becomes a spell; summons: every type of agent. They level up with use.
- Gold: 1 coin for every 10 points, to spend in the shop.
- Achievements unlock the unique items (golden name), which go straight into your backpack.
Everything is calculated from the conversation logs Claude Code itself writes to ~/.claude/projects.
Nothing leaves your computer, there is no network and no telemetry, and no conversation text is stored:
only counts.
Languages
The extension speaks Portuguese when VS Code is in Portuguese and English in any other language
(it follows VS Code's display language; changing it requires restarting VS Code). Skill and agent names
stay as they are.
Screens
- Status bar (bottom right): level, progress bar and gold. Click to open the character sheet. It glows
when something happens and turns yellow if counting stops (see "Watchdog").
- Character sheet: character (Deeds, Spells, Summons and Achievements tabs), a large figure wearing
what you equipped, inventory and backpack. Keys: L shop, M spellbook, S hall.
- Shop (L key): merchant on the left, the figure in the middle trying on the clicked item, inventory on
the right.
- Hall: in the bottom panel ("Tuca RPG" tab) and in the sheet's Hall mode. The hero walks in and waves
when it opens, sits at the desk while Claude works, casts when a skill is used, trains when an agent is
called, celebrates deliveries, glows on a new level, goes to the armchair after 5 idle minutes and to the
throne after 30.
Notifications
A new level and achievements show up in the corner of the screen; a new spell or class only makes the
status bar glow. With several VS Code windows open, only one notifies. Change it with tucaRpg.avisos
(grandes = big ones, todos = everything, nenhum = nothing).
Watchdog
If Claude Code changes the way it records conversations, the status bar turns yellow with "Tuca RPG stopped
counting" instead of the character silently stopping. Details in Tuca RPG: Show log (Output tab).
Commands
Tuca RPG: Open character sheet
Tuca RPG: Create character — name, appearance and "from scratch" or "use my history"
Tuca RPG: Change where counting starts — from scratch or history, without losing anything
Tuca RPG: Show log — what the game read and the errors
Settings
| Setting |
Default |
What for |
tucaRpg.pastaDados |
extension folder |
where the count journal, the character and the vault are kept |
tucaRpg.pastaRegistros |
~/.claude/projects |
where Claude Code records conversations |
tucaRpg.avisos |
grandes |
what becomes a notification in the corner of the screen |
License
Code under MIT; the artwork (hero, hall, icons, frames) is all rights reserved and may only be used inside
the extension. Screenshots and videos of it in use are free to share. Details in the LICENSE file. Tuca RPG is
an independent project: it is not made or endorsed by Anthropic; "Claude" and "Claude Code" are trademarks of
Anthropic, mentioned only to describe what the extension reads.
| |