lcoutodemos / chums

The AI you already use. Now on your keychain, your backpack or your wrist. 
 Chums puts the Claude Code and Codex already running on your Mac on an Apple Watch and an iPhone. 
 Hold the screen, say what you want, let go. Each agent is a character that acts out what it's doing.
 chums.club ·
 Setup ·
 Troubleshooting ·
 How it works ·
 Characters ·
 Contributing 
 No new model Your agents run on Claude Code or Codex, on your Mac. 
 No new subscription Chums is free and open source. The AI subscription you already have does the work. 
 No Chums account No Chums login. The watch and the iPhone talk to the hub on your own Mac. 
Everyone is building a cute new assistant: another subscription, another app, another company holding your data.
Chums is a team of agents on the AI you already pay for.
Each agent runs on Claude Code or Codex, picked per agent from the watch or the iPhone:
docs/other-agents.md.
**What you need:** an Apple Watch on watchOS 26 and the iPhone it is paired with (iOS 26), a Mac with Apple silicon
and Xcode 26, an Apple ID (a free one works), a free Tailscale account, and Claude Code or Codex. You build the apps
from source and run the hub on your Mac. The first setup takes 20–30 minutes, plus up to half an hour of waiting for
Xcode to prepare the watch and for a new Funnel address to reach public DNS. Requirements ·
Quickstart · Set it up with your agent
## Set it up with your agent
Chums is source code, not an App Store download. Paste this into Claude Code or Codex on your Mac. It does the setup
and stops when it needs your hands: signing in, plugging in your iPhone, turning on Developer Mode.
 [code] 
## What you can do from the watch
- **Talk to an agent.** Hold the screen, say what you want, let go. The Mac transcribes it and sends it to the agent.
- **See what it is doing.** The character acts out the agent's state: listening, thinking, working, waiting for you,
 done, blocked. Each tool call appears on screen as it runs.
- **Approve or deny actions.** When the agent asks for permission, hold the card to allow it or tap × to deny it.
- **Hear short replies.** The agent answers in one short sentence, spoken on the watch in the character's own voice (with the voices installed),
 and kept in a conversation you can scroll.
- **Get pictures.** Ask for a screenshot of your screen, an app or a web page, or for something the agent made; it
 arrives as a picture you can zoom.
- **Switch between agents.** Each agent is its own session and character. Tap the faces at the top left to pick one;
 what you say goes to the one on screen. Another agent's news arrives as a haptic tap.
- **Change who an agent is.** Say what should be different about an agent (its name, what it looks after, how it
 talks) and save the change. What it runs on, its model, its permissions and its voice are a tap away.
- **Carry it on your keys.** Keyring mode keeps the app on screen with the watch off your wrist.
## The iPhone app
The same agents and conversations