{"_id":"@7apislaz/huddy","_rev":"8-8923b6d57d66d8ef8fc05415278244d0","name":"@7apislaz/huddy","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@7apislaz/huddy","version":"0.1.0","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.1.0","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"56f5fac99b8926455e23b98b21603e922f2d7169","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.1.0.tgz","fileCount":52,"integrity":"sha512-HKPcg/uL1EpKTUmEZqWyIb7Qkm1ngifdgv2X3RjMZzH3P9KjRE0NcNHfAzmP+n9BFJSjp2ZJDhrceJBKFYKamA==","signatures":[{"sig":"MEUCICm5obJqyKylrlPIa/YiGknSou4hzklQDZFQnn1BCQn6AiEAiEBcGIzh2zuI9drL2/pILK3sBwMXYkKo3oB7kGVTf38=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94203},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"f09e12610bf1edf97043e4dcc0752bb7659b58aa","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.1.0_1775931532944_0.38003802994652625","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@7apislaz/huddy","version":"0.2.0","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.2.0","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"f1c2eae86804182a684db0cc504382c9593ecfbc","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.2.0.tgz","fileCount":56,"integrity":"sha512-hu20TT8LhLKGzd4sxA1s1Nod9Kfgencu23FangYBHTWiZtTl80/5bRDJUglsS99RwFY3tZtS579UPAgfNQWwNw==","signatures":[{"sig":"MEUCIDRFoDDsVINRny2MfqRGf2RV5BE1PUOvYJbm4mKoBkmyAiEA3icSBITwKor+t7VB2gbg2biQ53e9JEptXP4GAhAuNrs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101090},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"e29fa00eb3f80a25ca592de0924e617b3fd34af3","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.2.0_1775931947627_0.9615426514629393","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@7apislaz/huddy","version":"0.2.1","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.2.1","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"3ce4c3311b5e9f8b503e9b5bb3f288a38d078c48","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.2.1.tgz","fileCount":58,"integrity":"sha512-6DFHEGOAPp4taEqdH7Pel9hZg1MC4+zvz9bE+RB9y/scZwoH9uPHgEssZ0sEDwfJh0JeQrdGnWZxQGgwqcVILA==","signatures":[{"sig":"MEUCIQCod1ZDV5Opma5KtlLJL+HHwBp9somkFanNsMUqZr4QmwIgel6GQuY3Uyq3GzwXdk09wDu3voUlpSXSuAz+lz7Fl7M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112197},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"5ce7c976ab4822b0b8bd2911b1a8140685222df7","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.2.1_1775934349800_0.9451044148545455","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@7apislaz/huddy","version":"0.2.3","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.2.3","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"f67f43cfed229017b9d654a85653552391aecc14","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.2.3.tgz","fileCount":62,"integrity":"sha512-NctQlGYaslrJxoOlk72VeZ5bnH/JGjpzbXMvTW3t60REvAu8ooUuuyfaR7k+hyOTK9WWv4s5+9mpBdwZf5DgXg==","signatures":[{"sig":"MEUCIQDw1x9kFNhIu1jc8evZ0FSQBLmWz72fGPM6GKsxRFjmwQIgOA9bUtCHa9OebJ73GAtrhVOjVNv8gKcneKQ1Qot17Hc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":153684},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"59c490c194ee5a4398e9c9fe6db6bdfea4462677","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.2.3_1776087216200_0.7158046815831203","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@7apislaz/huddy","version":"0.2.4","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.2.4","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"ce101e665286abfa2275917216f3536511276c56","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.2.4.tgz","fileCount":64,"integrity":"sha512-VEKqWDC5Z6MSTBoG7J4XdTtFq3aD/04x4EJDIz2DkiSVfquG05n4w1mMyCu+M3HgxFTZVDB2OdjCL58mWBqeTQ==","signatures":[{"sig":"MEYCIQCPjZO+mkZRvX9Gkj/kbFSGOrKiaHwbhQ16fasMR/u+wAIhAJnetPeYPQA8tv7NtOgNhsr/p4IVHm7RZYV41pUVwLrZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157376},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d20925d95e7ae3c2203066ada592d010834a8b24","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.2.4_1776122640276_0.07575925914949533","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"@7apislaz/huddy","version":"0.2.5","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.2.5","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"4d0552e78ea186c8af92dac71d9e8000d0ba9d60","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.2.5.tgz","fileCount":72,"integrity":"sha512-hFvNsYSsPiVmlDxfdYnSBFygfrMOTufsfD/Lv4Z5phkPVYAZq2xHYw49DqxcWUvNAHg80w8JBzFtYjFhzt53wg==","signatures":[{"sig":"MEYCIQCuxILvmQpxsF4fKu/Te0JSNRisk1T3PrLF0OkyMravzQIhALA6fVI+3dG9IMIYL8uMVegneBe6zmSKCFTQ1juuPXG/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":158914},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"8d13b20f854915288de01e523461174f517f9163","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.2.5_1776217611828_0.21454431671027652","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@7apislaz/huddy","version":"0.3.0","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","_id":"@7apislaz/huddy@0.3.0","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"bin":{"huddy":"bin/huddy.mjs"},"dist":{"shasum":"8d4ba79ed557e739ee92cc5ab8ed16e55ccdd380","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.3.0.tgz","fileCount":75,"integrity":"sha512-LhPMAICzUTZ9Xm6RbaCXbNUfpFI3rb/3j0nQnx7cj6sirJHLIv5YQ+c13FXuNsd4PS7cMSPxzom6bqYjErRsaw==","signatures":[{"sig":"MEUCIQCsuJd0Z4vXno5b+Hi4wOtvB+76wxKOQ5xROnSia7HLswIgNTCBr/j/Npy5HfzcDEg2FiSj27EIBeW1MbglogIOabM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":170787},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"781ad5d27a4344b9f19b779d2ae9169a28ff8010","scripts":{"dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","build":"tsc","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"repository":{"url":"git+https://github.com/7apislaz/huddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/huddy_0.3.0_1776388786262_0.7401698155453513","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@7apislaz/huddy","version":"0.3.1","description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","type":"module","main":"dist/index.js","bin":{"huddy":"bin/huddy.mjs"},"scripts":{"build":"tsc","dev":"tsc --watch","test":"node --experimental-vm-modules node_modules/.bin/vitest run","test:watch":"node --experimental-vm-modules node_modules/.bin/vitest"},"keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"author":{"name":"7apislaz"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/7apislaz/huddy.git"},"homepage":"https://github.com/7apislaz/huddy#readme","bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"engines":{"node":">=18"},"devDependencies":{"@types/node":"^25.5.2","typescript":"^5.4.0","vitest":"^2.0.0"},"_id":"@7apislaz/huddy@0.3.1","gitHead":"7bfeef02ce5853b59912d2b29135d575d1c26069","types":"./dist/index.d.ts","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-4RoN8v/kB+DDurszSqCT6ZD6j9JzaINe0zgU+al/vhZ4xZtv6IoyRwTfpNNaOzb3S/8M16KmbIh9mW04+5ciZQ==","shasum":"14a5efc7ae037afe6d800e57ec89730dfe325ec4","tarball":"https://registry.npmjs.org/@7apislaz/huddy/-/huddy-0.3.1.tgz","fileCount":77,"unpackedSize":176981,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHi6mUQcXygik6enAbJ1aSFl92glPixBTdhVAndxhSWrAiABAaMZSDBnVHZcooEUU7DcZiIyIv8EO47moXytwpKy3g=="}]},"_npmUser":{"name":"7apislaz","email":"7apislaz@gmail.com"},"directories":{},"maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/huddy_0.3.1_1776390569993_0.88172915986646"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-11T18:18:52.854Z","modified":"2026-04-17T01:49:30.279Z","0.1.0":"2026-04-11T18:18:53.098Z","0.2.0":"2026-04-11T18:25:47.826Z","0.2.1":"2026-04-11T19:05:49.936Z","0.2.3":"2026-04-13T13:33:36.348Z","0.2.4":"2026-04-13T23:24:00.399Z","0.2.5":"2026-04-15T01:46:51.972Z","0.3.0":"2026-04-17T01:19:46.426Z","0.3.1":"2026-04-17T01:49:30.169Z"},"bugs":{"url":"https://github.com/7apislaz/huddy/issues"},"author":{"name":"7apislaz"},"license":"MIT","homepage":"https://github.com/7apislaz/huddy#readme","keywords":["claude-code","statusline","buddy","tamagotchi","cli","companion","ascii-art"],"repository":{"type":"git","url":"git+https://github.com/7apislaz/huddy.git"},"description":"Tamagotchi-style CLI companion for Claude Code — reactive buddy + optional HUD on the statusline","maintainers":[{"name":"7apislaz","email":"7apislaz@gmail.com"}],"readme":"# 🐣 huddy\n\n**Tamagotchi-style CLI companion for Claude Code**\n\n[![npm](https://img.shields.io/npm/v/@7apislaz/huddy)](https://www.npmjs.com/package/@7apislaz/huddy)\n[![CI](https://github.com/7apislaz/huddy/actions/workflows/ci.yml/badge.svg)](https://github.com/7apislaz/huddy/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nYour coding buddy lives in the Claude Code statusline — reacting to your context usage, celebrating successes, and getting sleepy when things get heavy.\n\n![huddy demo](docs/demo/demo.gif)\n\n---\n\n## Requirements\n\n- [Claude Code](https://claude.ai/code) installed\n- Node.js >= 18\n\n---\n\n## Quick Start\n\n```bash\nnpm i -g @7apislaz/huddy\nhuddy setup\n```\n\nRestart Claude Code — your buddy appears on the statusline!\n\n---\n\n## Characters\n\n### 🌟 Brand Mascot\n\nMeet **Peekcat** — huddy's signature character. Always hiding behind the wall, only the ears stay visible no matter what mood it's in. Default character for new installs.\n\n```\n   · ✦      \n            \n   ∧   ∧    \n  (ㅇㅅㅇ)  \n ∪━━━━━━━∪  \n   Peekcat\n  (peekcat) — RARE\n```\n\n### 😺 12 More Friends\n\n```\n    __          /\\_/\\      .----.      .---.      (\\ /)\n __(° >        ( ° ° )    ( °  ° )    ( ° ° )     ( ° °)\n(  ._>  )       ( ω )     (  ω   )    >( ω )<     ( ω  )\n \\__)--´        /| |\\~     `----´      (___) ~    (  uu)~\n  ~~~~         (_)_(_)                 _|_|_       ~~~~\n  Quacky       Whiskers     Blobby     Waddle       Bun\n  (duck)        (cat)       (blob)    (penguin)   (rabbit)\n\n  /\\  /\\       .----.       .----.     /^\\ ~    }~ .----. {\n (( °° ))     ( ° ° )      ( ° ° )   ( °  ° )     ( °  ° )\n  ( >< )       ( ω )        ( ω )     ( ~~ )       ( ω  )\n  /|  |\\      /\\/\\/\\/\\     (      )  /\\/vvv\\/\\    /`----´\\\n  \\|__|/       ~~  ~~~    ~`~ ~`~ ~               ~~  ~~~~\n   Hoot         Inky         Boo       Ember        Axie\n   (owl)      (octopus)    (ghost)    (dragon)    (axolotl)\n\n q .--. p     (°) (°)\n( °  w °)    ( °  w °)\n (     )~   >( _____ )<\n  \\____/      ( u_u )\n  /|  |\\        \\___/\n  Biscuit       Mochi\n  (dog)       (hamster)\n```\n\n---\n\n## Commands\n\n### Setup\n\n```bash\nhuddy setup\n```\n\nRegisters huddy as the Claude Code statusline provider. Restart Claude Code after running.\n\n---\n\n### Pick your character\n\n```bash\nhuddy select               # Browse all 13 characters with preview\nhuddy select peekcat       # Directly select a character\n```\n\nAvailable: `peekcat` `duck` `cat` `blob` `penguin` `rabbit` `dog` `hamster` `owl` `octopus` `ghost` `dragon` `axolotl`\n\n---\n\n### Random roll\n\n```bash\nhuddy random\n```\n\nRandomly picks a character + color. **20% chance for rainbow** — every line gets a different color!\n\n```\n✦ Ember + 🌈 RAINBOW!\n```\n\n---\n\n### Configuration\n\n```bash\nhuddy config show                    # View all settings\nhuddy config set character dragon    # Change character\nhuddy config set name \"Ember\"        # Rename your buddy\nhuddy config set color cyan          # Change color\nhuddy config set hud off             # Hide the HUD line\nhuddy config set lang ko             # Switch to Korean\nhuddy config set lang en             # Switch to English (default)\n```\n\n---\n\n### Rename your buddy\n\n```bash\nhuddy rename \"Spark\"    # Give your buddy a new name\n```\n\n---\n\n### Reset state\n\n```bash\nhuddy reset    # Reset happiness and counters back to defaults\n```\n\nAvailable colors: `red` `green` `yellow` `blue` `magenta` `cyan` `white`\n\nSettings are saved in `~/.huddy/config.json`.\n\n---\n\n### Buddy info & stats\n\n```bash\nhuddy info     # Show current buddy with RPG stats and happiness bar\nhuddy stats    # Show lifetime stats (sessions, successes, errors, first seen)\n```\n\n---\n\n### Toggle HUD\n\n```bash\nhuddy hud      # Toggle HUD on/off\n```\n\n---\n\n### Feed your buddy\n\n```bash\nhuddy feed     # Give a snack — happiness +15!\n```\n\nHappiness decays over time (−2/hr, max −20). Keep your buddy happy!\n\n---\n\n## HUD\n\nStats appear **to the right of the buddy art** on the statusline:\n\n```\n   · ✦          huddy#0.3.1\n                ctx:45%  ses:42m\n   ∧   ∧        5h:12% (3h20m)  7d:5%\n  (ㅇㅅㅇ)      Peekcat LV.12 ♥85\n ∪━━━━━━━∪\n```\n\n| Field | Description |\n|-------|-------------|\n| **ctx** | Context window usage — green → yellow at 70% → red at 85% |\n| **ses** | How long the current session has been running |\n| **5h / 7d** | Rate limit usage with time until reset |\n| **name LV ♥** | Buddy name + level (grows with sessions/successes/cost) + happiness (0–100, green → yellow at 40 → red below) |\n\nToggle the HUD on/off with `huddy hud`, or use `huddy config set hud off` to disable.\n\n---\n\n## How It Works\n\nhuddy runs as a Claude Code [statusline provider](https://docs.anthropic.com/en/docs/claude-code/statusline):\n\n```\nClaude Code → statusline tick → stdin JSON\n                                    ↓\nhuddy → parse context% / transcript → determine emotion\n      → render ASCII art + HUD → stdout\n                                    ↓\nClaude Code → display on statusline\n```\n\n### Emotions\n\n| Emotion | Trigger |\n|---------|---------|\n| **idle** | Default state |\n| **working** | Active tool calls detected (last 3 min) |\n| **happy** | Tool success, commits |\n| **excited** | 5+ consecutive successes |\n| **sad** | Errors, failures |\n| **tired** | Context > 60% usage |\n\n---\n\n## Slash Commands (Claude Code)\n\nCopy command files to use slash commands inside Claude Code:\n\n```bash\nmkdir -p ~/.claude/commands\ncp $(npm root -g)/@7apislaz/huddy/docs/commands/*.md ~/.claude/commands/\n```\n\n| Command | Description |\n|---------|-------------|\n| `/huddy` | Register buddy on statusline (initial setup) |\n| `/huddy-select` | Browse & pick character |\n| `/huddy-select cat` | Directly select a character |\n| `/huddy-random` | Random roll (20% rainbow!) |\n| `/huddy-feed` | Give your buddy a snack (happiness +15) |\n| `/huddy-info` | Show buddy info with RPG stats |\n| `/huddy-stats` | Show lifetime stats |\n| `/huddy-rename Spark` | Rename your buddy |\n| `/huddy-reset` | Reset happiness & counters |\n| `/huddy-hud` | Toggle HUD on/off |\n| `/huddy-config show` | View all settings |\n| `/huddy-config set color cyan` | Change a setting |\n| `/huddy-lang ko` | Switch to Korean |\n| `/huddy-lang en` | Switch to English |\n\n---\n\n## Use with oh-my-claudecode\n\nClaude Code supports one statusline command. To run huddy alongside [oh-my-claudecode](https://github.com/7apislaz/oh-my-claudecode):\n\n```bash\nmkdir -p ~/.claude/hud\ncp $(npm root -g)/@7apislaz/huddy/docs/wrapper/huddy-wrapper.mjs ~/.claude/hud/\n```\n\nUpdate `~/.claude/settings.json`:\n\n```json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"node ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hud/huddy-wrapper.mjs\"\n  }\n}\n```\n\n---\n\n## Install from Source\n\n```bash\ngit clone https://github.com/7apislaz/huddy.git\ncd huddy\nnpm install && npm run build\nnpm link\nhuddy setup\n```\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}