kiloforgeai / codenamejo

# Codename Jo
A hands-free voice assistant for your inbox and the tools around it. You talk, and Jo walks
you through your mail. It:
- reads you the week, ranked by what matters
- summarises, drafts and sends replies
- archives, labels and unsubscribes
- puts things on your calendar
- hands longer jobs to a background worker, so the conversation keeps moving
**Fully client-executed.** Every tool, ranking, summary and decision runs on your phone, on
your own OpenAI key. The only server is a thin, stateless Google connection shim that adds
our verified client's secret to Google's token calls. It stores nothing and never sees your
mail.
This repository is the iOS app (SwiftUI), with a watchOS companion and a Live Activity.
## What runs where
| Piece | Where it runs |
|---|---|
| Voice session (`gpt-live-1`) and the reasoning model behind it (`gpt-5.6-luna`) | OpenAI, called straight from the phone with your API key |
| Gmail and Calendar reads and writes | The phone, calling Google's APIs directly |
| Ranking your mail by importance, email summaries, per-category playbooks | The phone, which asks OpenAI on your key |
| The mail queue, profiles, history, settings | The phone's local database |
| Your Google, Notion, Granola, Slack, GitHub and custom MCP credentials | The phone's Keychain |
| Google sign-in and token refresh | Our hosted token shim, which adds the web client's secret to Google's token request and returns the result. It has no database and never logs tokens |
What leaves your phone, and to whom:
- **To OpenAI, on your key:** your voice, and the mail, calendar and connector content Jo
 needs to answer you. That means senders, subjects and previews, plus full message bodies
 when Jo reads them.
- **To Google, Notion, Granola, Slack, GitHub and any MCP server you add:** the API calls Jo
 makes for you, with your own tokens.
- **To the token shim:** a Google sign-in code or refresh token, once at sign-in and about
 once an hour per account after that. Nothing about your mail.
- **To Hugging Face:** a one-time download of the local voice model and its pronunciation
 lexicon, the first time the local voice is used. Nothing about you goes with it.
There is no analytics, telemetry, push, call recording or feedback upload.
## Connectors
| Connector | How you connect | What Jo can do |
|---|---|---|
| **Gmail and Google Calendar** | Google sign-in during onboarding. Add more inboxes in Settings | The core: read, rank, summarise, draft, send, forward, archive, trash, label, filter, unsubscribe; read and change your calendar |
| **Notion** | Settings → Connections | Search, read pages and databases, add notes, create pages, update properties. It can't delete pages: Notion's MCP server has no tool for it |
| **Granola** | Settings → Connections | List meetings, read notes, pull action items |
| **Slack** | Settings → Connections | Walk your unread Slack in a call (important Slack after important mail), read channels and threads, send, schedule, rea