Agentchi ⌚️
Your coding agents on your wrist, with a pixel-art companion.
Permission requests, questions, finished tasks: it all lands on your Wear OS watch and you answer with a tap. Meanwhile Chi, your mascot, lives in sync with your sessions. For Claude Code and Codex, on watches with Google Play services (Galaxy Watch 4 and newer).
→ agentchi.dev: the overview, the video, and ready-to-copy commands.
Unofficial app, not affiliated with Anthropic or OpenAI. Claude and Claude Code are trademarks of Anthropic; Codex and OpenAI are trademarks of OpenAI.
A day with your agent
- 🔐 It asks for permission: allow, deny with or without a reason, or pick "always" so you're never bothered about it again. A countdown tells you how long it will wait for you.
- 🧩 It hesitates, you decide: tick one or several options of a question, or dictate another answer. A plan to review? Approve it or ask for changes.
- 📋 You know who's working: your active sessions at a glance (working, waiting for your answer, done), the ones waiting on you first.
- 🎉 It celebrates your wins: task done, Chi throws a party and earns experience. You can reply with the keyboard, by voice or with a quick reply.
- 🍪 And it gets hungry: fullness, energy and happiness drop over time. Feed it, play with it, give it a cuddle, clean up its poops. It panics when your agent needs you.
- 🔥 Your streaks count: days in a row with finished tasks, answers given from the watch, achievements that unlock as your sessions go by.
- 🌙 It respects your nights: quiet hours, Do not disturb and Bedtime mode. Non-urgent events are bundled into a single summary, only urgent ones get through.
Make it your own: 3 species, 6 colors, 5 accessories, which follow your mascot onto the tile, the complication, the Agentchi watch face and even the app icon. Your agents' Markdown stays readable on the round screen, alerts are configurable (full screen, silent, vibration, sound), and there's no app to install on your phone.
How it works
Claude Code (computer, Remote Control) ──agentchi plugin──────────┐
claude.ai/code cloud session ───────────repo http hook────────────┼──HTTPS──▶ agentchi.dev ──FCM──▶ your watch
Codex (CLI, app, IDE) ──────────────────~/.codex/hooks.json───────┘
Your agents send their events through their hooks to the Agentchi server, which pushes them right away to your watch via Firebase Cloud Messaging. The server is open source: you can use agentchi.dev or host your own.
- Nothing piles up: events go straight to the right watch without being kept; the server only stores registered watches and a hash of their codes.
- One code per computer: each computer or cloud environment is paired with its own code (
XXXX-XXXX-XXXX), created on the watch and revocable from it.
- No account, no ads: each watch registers itself and only receives its own events.
| Where the agent runs | How the watch is notified |
|---|
| Claude Code: terminal, IDE, Desktop app | agentchi plugin |
| Claude Code in Remote Control (claude.ai/code, mobile app) | Plugin: the session runs on your computer |
| Cloud session on claude.ai/code | http hook in the repo's .claude/settings.json: cloud sessions don't load plugins |
| Codex: CLI, app, IDE extension (macOS, Linux, WSL) | Codex hooks (~/.codex/hooks.json or the agentchi-codex plugin) |
| claude.ai chat, ChatGPT | Not supported: no hooks |
Install Agentchi
The watch app is in English, or in French when the watch is set to French (Wear OS 4+ also lets you pick the app's language in the system settings).
1. The app on your watch
Agentchi will install from the Google Play Store, right on your Wear OS watch: the listing is coming soon. Until then, the CI build of the APK installs with adb (see the self-hosting guide).
Open Agentchi, allow notifications, then go to Settings › Server: enter https://agentchi.dev and tap Connect the watch.
2. One code per computer
On the watch: Settings › Server › New code, name the computer and write down the XXXX-XXXX-XXXX code. Plan one code per computer or cloud environment: each one can be revoked separately.
3. Hook up your agents
Claude Code (terminal, IDE, Desktop app, Remote Control)
A single command, with your code:
claude plugin install agentchi --marketplace Pelagoss/agentchi \
--config server_url=https://agentchi.dev --config code=XXXX-XXXX-XXXX
That's it, for all your projects. The code is stored in the system keychain, not in settings.json. Without --config, Claude Code prompts for both values (/plugin › agentchi › Configure options). Requires curl, available by default on macOS, Linux and Windows 10+. The plugin also covers local sessions you follow in Remote Control from claude.ai/code or the mobile app.
You can also add the Pelagoss/agentchi marketplace in claude.ai › Customize › Plugins: the plugin then syncs to every computer where you sign in to Claude Code. All that's left is entering the code.
Claude cloud sessions (claude.ai/code)
Cloud sessions don't load plugins, but they do run the repo's hooks:
- Add to the repo's
.claude/settings.json the block served by https://agentchi.dev/v1/cloud-settings.json. It's an http hook that sends Authorization: Bearer $AGENTCHI_CODE.
- On the watch, create a code for this cloud environment.
- In the cloud environment settings on claude.ai/code:
- environment variable
AGENTCHI_CODE=XXXX-XXXX-XXXX;
- custom network access that allows
agentchi.dev.
Everyone working on the repo puts their own code in their environment. Without a code, the hook does nothing and shows no error. On a computer, the variable isn't set, so there are no duplicates with the plugin.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
