Skills

The pet ships an agentskills.io-compliant skill so your AI coding agent can drive it directly. Ask Claude "make the tamagotchi happy" or "show 'build passed' on the device" and the skill takes care of the rest, talking to the local gochi CLI server.

Connect your agent in one message

The fastest way: paste this into your agent's chat and it will install the skill itself.

Read https://gochi.in/skill.md and follow the instructions to install
the gochi skill on this machine.

The page is the skill source — agents that understand skill.md (Claude Code, OpenClaw, Hermes, and others) read it, drop the files into the right place, and are ready to drive the pet once the CLI is running.

Prefer to install it yourself? Keep reading.

Install with npx skills

Use npx skills — Vercel Labs' universal installer. It auto-detects which agents you have installed and drops the skill into the right place for each.

npx skills add devfolioco/gochi

npx skills add devfolioco/gochi -g

# one agent
npx skills add devfolioco/gochi -a claude-code

# several at once, global
npx skills add devfolioco/gochi -a claude-code -a openclaw -a hermes-agent -g

Restart the agent (or open a new session) and the tamagotchi skill is auto-discovered. That's it.

Prerequisite: the CLI

The skill drives the pet through the gochi CLI and its background server. One-time setup:

git clone https://github.com/devfolioco/gochi.git
cd gochi/cli
bun install
bun link                # registers the `gochi` command globally
gochi server install    # writes a launchd plist (macOS) — auto-starts at login

export PATH="$HOME/.bun/bin:$PATH"   # add to ~/.zshrc or ~/.bashrc to persist

Verify:

gochi server status
gochi health

You should see connected: true and the pet should be reachable.

Manage installed skills

npx skills list              # what's installed where
npx skills update tamagotchi # pull latest from the source repo
npx skills remove tamagotchi # uninstall

What the agent can do

Once the skill is loaded, the agent has full access to the pet's behavior. Plain-English prompts that work:

• "Make the tamagotchi happy"
• "Set the mood to playful"
• "Show 'build passed' on the screen"
• "What face is the tamagotchi showing right now?"
• "List every face it supports"

The skill can also react to task outcomes automatically — build pass → happy, fail → sad, long wait → sleepy — if your agent's prompt opts in.

Smoke test

After install, confirm the whole stack works end-to-end:

gochi health        # → ok, connected:true
gochi face happy    # → device shows the happy face
gochi face neutral  # → reset

Then ask your agent something like "make the tamagotchi blink" — it should call the skill, the skill calls the server, the server pushes a command over USB, and the eyes blink.

Supported agents

npx skills writes to the standard skill location for each agent:

50+ other agents (Codex, Cursor, opencode, Cline, Gemini CLI, …) work the same way. See the full table in vercel-labs/skills.

Manual install

If you'd rather not run npx, clone the repo and symlink the skill folder yourself. A symlink means git pull updates the skill for every agent at once.

git clone https://github.com/devfolioco/gochi.git ~/src/gochi

mkdir -p ~/.claude/skills
ln -s ~/src/gochi/skills/tamagotchi ~/.claude/skills/tamagotchi

Repeat for whichever agent paths apply (table above).

Troubleshooting