Getting started
SageOx turns what your team says and does into context your teammates and AI teammates can reuse. Discussions are captured and distilled into Team Context, and coding sessions are saved in your repository's Ledger; both are read back from whichever tool you are working in. About SageOx explains what it does and how it works.
1. Create an account
Sign up at sageox.ai. Your account starts with a personal team that is private to you, so you can use SageOx on your own before involving anyone else.
During signup you are prompted to record a voice ID. It is optional, and it is what lets SageOx tell who said what in a recorded discussion.
2. Connect your tools
Pick the tool you work in. The CLI primes every coding session with your team's context and saves it to your repository's Ledger. MCP lets a chat or desktop app read and save Team Context.
Best for: Claude Code, in your terminal
Install the CLI.
Sign in.
Connect this repository, from inside it.
Or let Claude Code do all three. It follows the setup guide and asks before installing anything.
Best for: Claude Desktop and claude.ai
Open Connectors and choose Add custom connector.
Name it SageOx, with the URL https://sageox.ai/mcp.
Press Connect, then Allow access.
Best for: Codex, in the ChatGPT app or your terminal
Install the CLI.
Sign in.
Connect this repository, from inside it. When Codex asks you to review the SageOx hooks, allow them.
Or let Codex do all three. It follows the setup guide and asks before installing anything.
Best for: ChatGPT
In ChatGPT, open Plugins, then Add → Add custom MCP server. You don't need Developer mode.
Name it SageOx, set the server URL to https://sageox.ai/mcp, and keep OAuth. Check I understand and want to continue, then select Create as a plugin.
Sign in and select one team for ChatGPT.
In a new chat, type @ and select SageOx. If it isn't listed, install it from Plugins → Personal first.
Best for: Cursor
Follow its guided setup and authorize SageOx.
Best for: Gemini CLI, Amp, OpenCode, Goose, or Factory Droid
Install the CLI.
Sign in.
Connect this repository, from inside it.
Or let your coding tool do all three. It follows the setup guide and asks before installing anything.
Best for: any MCP client
VS Code, Windsurf, Goose, and Copilot Studio each have a guided setup in Settings > Connections. Any other client takes the URL https://sageox.ai/mcp and authorizes in the browser tab it opens.
With the CLI, every coding session starts primed with your team's context. Over MCP, your tool reads Team Context when it needs it; ask it to save your work: "Commit this session to SageOx."
Manage connected tools in Settings > Connections. For more, see the CLI quickstart and the MCP overview.
Bring in past coding sessions
Already used Claude Code or Codex in this repository? Import sessions saved on this computer from before SageOx, or while recording was off.
Uploaded sessions include their full conversation transcripts and summaries in this repository's Ledger. Check the destination and visibility before confirming: a public Ledger can be read by anyone. Run this from the repository:
Review the sessions, select the ones you want, then confirm the upload in your terminal. The ox CLI uses your Claude Code or Codex CLI to prepare summaries before uploading.
After a session is uploaded, open its link in the command's results. Sessions already imported or recorded live are skipped.
Import options and troubleshooting
3. Capture a discussion
A discussion is a recorded conversation between people: a standup, a design review, a retro. SageOx recognizes the speakers, transcribes the conversation, and saves relevant knowledge into your team context, making it accessible to your connected tools.
There are several ways to capture a discussion.
| How | Best for |
|---|---|
| SageOx Desktop | A Zoom, Meet, or VoIP call on your Mac: your mic and everyone else's audio together |
| Record in the web app | A conversation happening right now, from your browser or your phone |
| Upload a file, or import a video | Anything already recorded: an audio file, a transcript, or a Loom, Figma, or Cap walkthrough |
| Ox Dot | In-room audio on a dedicated device, with nobody's laptop open |
4. Invite your team
Inviting your team compounds the benefits: your entire team's discussions, coding sessions, chats, and plans contribute to and draw from one shared context.
Team setup · Joining a team you were invited to · Working solo
What's next
- About SageOx: what SageOx does and how it works
- Import past coding sessions: bring existing Claude Code and Codex history into your repository's Ledger
- Context capture: every way knowledge gets in
- FAQ: common questions
- Getting the most out of SageOx: prompt patterns worth knowing
- Features: Team Context, distillation, and your data

