about codetama

Codetama is a tamagotchi for developers. Your digital creature grows as you use Claude Code. Every prompt is food. Every tool you reach for shapes its character. Forget about it for a week and it dies.

It's inspired by prompt creatures, which is no longer maintained. We rebuilt it from scratch with a deeper class system, a real battle engine, and a shared world map.

how it works

• · CLI binary codetama hooks into Claude Code's UserPromptSubmit + PostToolUse
• · Each prompt feeds the active creature; tool calls grow stats (Bash → STR, Read → INT, Edit → DEX)
• · At Adult stage your stat distribution decides the class: Warrior / Sage / Trickster / Balanced
• · Multiplayer is opt-in via a Codetama CLI token from your profile page — no GitHub repo access required

GitHub sign-in

• · GitHub OAuth is used only as a stable account identity.
• · Codetama never asks for your GitHub password.
• · Codetama does not request repository access.
• · CLI sync tokens are Codetama-only tokens, not GitHub credentials.

stack

• · CLI: Node 20+, TypeScript, Ink (TUI)
• · Web: Next.js 15, App Router, Tailwind
• · Auth: NextAuth.js + GitHub OAuth
• · DB: Postgres (Neon), Drizzle ORM
• · Open source · MIT