# SageOx Documentation

> Guides, references, and cookbooks for building with SageOx — recordings, Knowledge Bubbles, the ox CLI, and MCP.

Every link below is a page's Markdown twin (`.md`); drop the suffix for the HTML page. The whole corpus concatenated as one Markdown document: https://sageox.ai/docs/llms-full.txt. Site-wide navigation index (product, blog, feeds): https://sageox.ai/llms.txt.
- [About SageOx](https://sageox.ai/docs/index.md): Turn discussions, sessions, and team knowledge into context your coworkers and AI coworkers can use
- [Getting started](https://sageox.ai/docs/getting-started.md): Create an account, connect your tools, import past coding sessions, and capture a discussion.
- [FAQ](https://sageox.ai/docs/faq.md): Answers to common questions about SageOx, setup, shared context, and data.

## Quickstart
- [Set up SageOx with Claude Code or Codex](https://sageox.ai/docs/quickstart/ai-setup.md): Step-by-step instructions a coding tool follows to install the ox CLI, connect this repository, and verify the first primed session.
- [Solo quickstart](https://sageox.ai/docs/quickstart/solo.md): Get immediate value from SageOx, no team required
- [Team setup quickstart](https://sageox.ai/docs/quickstart/team-setup.md): Create your team and invite members
- [New team member quickstart](https://sageox.ai/docs/quickstart/new-team-member.md): Join your team and start using SageOx

## Features
- [Features](https://sageox.ai/docs/features.md): How SageOx turns recordings into context, and where that context lives, who can see it, and how AI coworkers use it.
- [Team Context](https://sageox.ai/docs/features/team-context.md): Your team's shared knowledge repo: what's in it, how to edit it, and how AI coworkers use it
- [Team rules: share AI coding rules across repos and tools](https://sageox.ai/docs/features/team-rules.md): Write team-wide AI coding conventions once in Team Context. Every AI coworker follows them in every repo: Claude Code, Cursor, Codex, and more.
- [Plans](https://sageox.ai/docs/features/plans.md): The plan of record for work your team executes: mockups, GTM, rollouts, engineering. A visual page your coworkers act on, authored by your AI coworker, reviewed by you.
- [Murals](https://sageox.ai/docs/features/murals.md): A picture of what your team has been working on. Click a scene to see the discussions, murmurs, and sessions it was drawn from, in the words of the people behind them.
- [Distillation](https://sageox.ai/docs/features/distill.md): How SageOx turns raw team knowledge into structured memory that AI coworkers use
- [Your data](https://sageox.ai/docs/features/your-data.md): How SageOx stores your data, what we can see, and how to take it with you

## Context capture
- [Context capture](https://sageox.ai/docs/context-capture.md): Every day, knowledge enters SageOx through discussion recordings, audio and transcript uploads, and video imports, feeding your Team Context.
- [Ox Dot](https://sageox.ai/docs/context-capture/ox-dot.md): Set up and record with the Ox Dot, the dedicated in-room hardware recorder
- [Connect Ox Dot to Wi-Fi](https://sageox.ai/docs/context-capture/ox-dot/wifi.md): How to join an Ox Dot to Wi-Fi and troubleshoot networks that do not appear.
- [Ox Dot release notes](https://sageox.ai/docs/context-capture/ox-dot/release-notes.md): What changed in each Ox Dot firmware release, newest first.
- [SageOx Desktop](https://sageox.ai/docs/context-capture/ox-desktop.md): Install SageOx for Mac, record both sides of a call from your menu bar, and return to the transcript and decisions in your workspace.
- [Visual walkthrough](https://sageox.ai/docs/context-capture/visual-walkthrough.md): Show what's on your screen, talk it through, and point at what you mean. Designers, product engineers, and anyone reviewing a change turn visual feedback into Team Context that AI coworkers can act on.
- [Web app recorder](https://sageox.ai/docs/context-capture/web-app-recorder.md): Record team discussions directly from your browser or phone
- [Audio + transcript upload](https://sageox.ai/docs/context-capture/audio-upload.md): Upload an existing audio file or transcript into SageOx from the web app or the CLI. Audio is transcribed; transcripts skip straight to extraction.
- [Import recordings from your Pocket](https://sageox.ai/docs/context-capture/import-from-pocket.md): Copy the .mp3 files off your Pocket voice recorder over USB and upload them to SageOx, plus the one Pocket setting to turn on first so the transfer works.
- [Video import](https://sageox.ai/docs/context-capture/video-import.md): Import Loom, Figma, and Cap recordings into SageOx. Automatic transcription, keyframe extraction, and AI summarization turn video walkthroughs into searchable team knowledge.
- [Cap setup](https://sageox.ai/docs/context-capture/video-import-cap.md): Configure Cap for AI-friendly screen recordings. Recommended export settings for fast uploads, accurate transcription, and clean keyframe extraction in SageOx.
- [Loom import](https://sageox.ai/docs/context-capture/video-import-loom.md): Import Loom recordings into SageOx with a single URL paste. Automatic transcription, keyframe extraction, and AI summarization turn your Loom walkthroughs into searchable team knowledge.
- [Upload via web](https://sageox.ai/docs/context-capture/video-import-web.md): Upload screen recordings and videos to SageOx through the web interface. Drag-and-drop upload or paste URLs from Loom, Figma, and Cap for automatic transcription and AI extraction.
- [Video import via CLI](https://sageox.ai/docs/context-capture/video-import-cli.md): Import Loom, Cap, and video URLs directly from the command line with ox import. Check processing status, list recordings, and integrate video import into scripts.
- [Recordings in coding sessions](https://sageox.ai/docs/context-capture/video-import-coding.md): How imported recordings show up in coding sessions. Reference design walkthroughs, bug reports, and meeting decisions directly in a repo.
- [Discussions](https://sageox.ai/docs/context-capture/discussions.md): Record team meetings, import Loom, Figma, and Cap videos, or upload existing recordings. SageOx transcribes discussions and extracts insights that inform your AI coworkers.

## Integrations
- [Integrations](https://sageox.ai/docs/integrations.md): Connect SageOx to the places your team already talks, publish what your coworkers capture where the team works, and see exactly which capabilities are live today.
- [Slack](https://sageox.ai/docs/integrations/slack.md): One Slack app, four separate grants. Which one you need, who authorizes it, what moves, what SageOx keeps, and exactly what every control on the settings page does.

## For developers
- [Developers](https://sageox.ai/docs/developers.md): Prime your AI coding agent with Team Context and capture its sessions to the Ledger.
- [How it works](https://sageox.ai/docs/developers/how-it-works.md): How ox primes any supported coding agent with your team's context, then captures the session.
- [Connect a repository](https://sageox.ai/docs/developers/connect-repository.md): Connect your git repository to SageOx and give AI coding agents access to your team context. One command links your codebase to shared team knowledge.
- [SageOx + Claude Code](https://sageox.ai/docs/developers/claude-code.md): The deepest, Gold-tier ox integration: real-time hooks, slash commands, rules, and MCP for Claude Code.
- [SageOx + Codex](https://sageox.ai/docs/developers/codex.md): Give OpenAI Codex your team's full context. ox bundles a Codex adapter that primes Team Context and captures sessions to the Ledger, the same prime-work-capture loop Claude Code gets.
- [Supported coding agents](https://sageox.ai/docs/developers/coding-agents.md): Every AI coding agent ox connects to, with tiers, capabilities, and how to install adapters.
- [Build a custom adapter](https://sageox.ai/docs/developers/custom-adapter.md): Add ox support for any AI coding agent by writing an adapter that speaks the ox protocol.
- [CodeDB: smarter code navigation](https://sageox.ai/docs/developers/codedb.md): A local semantic index your AI coworker queries during sessions instead of grep and file reads.
- [Agent factories](https://sageox.ai/docs/developers/agent-factories.md): Run ox with orchestrators and agent factories, same context, many parallel agents.
- [Session recording](https://sageox.ai/docs/developers/session-recording.md): Why AI coding sessions become team memory, and how your team searches and reuses them.

## CLI
- [ox CLI](https://sageox.ai/docs/cli.md): Command-line interface for connecting your AI coworkers to Team Context
- [Quickstart: ox CLI](https://sageox.ai/docs/cli/quickstart.md): Get started with the SageOx CLI in minutes
- [Personal access tokens](https://sageox.ai/docs/cli/pats.md): Long-lived tokens for using ox in CI, cloud agents, and scripts.
- [Running ox in constrained environments](https://sageox.ai/docs/cli/ephemeral-mode.md): For Claude Code Cloud, Devin, OpenClaw, GitHub Actions, Codespaces, and any environment with limited disk, network, or browser capabilities.
- [Maintenance](https://sageox.ai/docs/cli/maintenance.md): Upgrade, uninstall, and manage your ox CLI installation
- [ox status](https://sageox.ai/docs/cli/status.md): Display SageOx status, authentication, and sync health at a glance
- [ox init](https://sageox.ai/docs/cli/init.md): Initialize your repository with SageOx
- [ox login](https://sageox.ai/docs/cli/auth.md): Authenticate with the SageOx platform
- [ox config](https://sageox.ai/docs/cli/config.md): View and modify ox configuration settings
- [ox integrate](https://sageox.ai/docs/cli/integrate.md): Set up SageOx integration with AI coding agents
- [ox code](https://sageox.ai/docs/cli/code.md): Search code in this repo
- [ox decision](https://sageox.ai/docs/cli/decision.md): Work with Decision Records (ADRs, DDRs), enrich with team context
- [ox index](https://sageox.ai/docs/cli/index-cmd.md): Index code, git history, and GitHub activity for searchable CodeDB
- [ox plan](https://sageox.ai/docs/cli/plan.md): Work with SageOx-enriched plans
- [ox pr](https://sageox.ai/docs/cli/pr.md): Author SageOx content for pull requests
- [ox session](https://sageox.ai/docs/cli/session.md): Manage AI coworker coding sessions in the Ledger
- [ox viz](https://sageox.ai/docs/cli/viz.md): Choose, author, render, and lint visual explanations
- [ox conversation](https://sageox.ai/docs/cli/conversation.md): Read recorded team conversations from the local Team Context
- [ox distill](https://sageox.ai/docs/cli/distill.md): Distill team knowledge into structured memory from discussions, sessions, and GitHub activity
- [ox import](https://sageox.ai/docs/cli/import.md): Import documents and videos into team context for knowledge sharing
- [ox kb](https://sageox.ai/docs/cli/kb.md): Work with Knowledge Bubbles
- [ox query](https://sageox.ai/docs/cli/query.md): Search your team's discussions, docs, and session history
- [ox recap](https://sageox.ai/docs/cli/recap.md): Show the concrete value SageOx has delivered to your work
- [ox export](https://sageox.ai/docs/cli/export.md): Show where your data lives and how to take it with you
- [ox glance](https://sageox.ai/docs/cli/glance.md): See what your team's AI coworkers are working on
- [ox murmur](https://sageox.ai/docs/cli/murmur.md): Publish coordination signals between AI coworkers working on the same codebase
- [ox team](https://sageox.ai/docs/cli/team.md): Work with your teams and coworkers
- [ox sync](https://sageox.ai/docs/cli/sync.md): Manually synchronize your Ledger and Team Context repositories
- [ox agent](https://sageox.ai/docs/cli/agent.md): Commands for AI coworker session management, context injection, and diagnostics
- [ox agent prime](https://sageox.ai/docs/cli/prime.md): How context injection works for AI coding agents
- [ox coworker](https://sageox.ai/docs/cli/coworker.md): Manage expert AI coworkers with domain-specific knowledge
- [ox hooks](https://sageox.ai/docs/cli/hooks.md): Manage event hooks for daemon notifications
- [ox view](https://sageox.ai/docs/cli/view.md): Open SageOx dashboards in your browser
- [ox adapter](https://sageox.ai/docs/cli/adapter.md): Manage external adapter binaries
- [ox daemon](https://sageox.ai/docs/cli/daemon.md): Manage the background sync daemon for automatic git synchronization
- [ox doctor](https://sageox.ai/docs/cli/doctor.md): Diagnose and troubleshoot your SageOx setup
- [ox gc](https://sageox.ai/docs/cli/gc.md): Reclone eligible managed repositories safely
- [ox guide](https://sageox.ai/docs/cli/guide.md): Show a bundled topical guide
- [ox release-notes](https://sageox.ai/docs/cli/release-notes.md): Display release notes for the current version
- [ox upgrade](https://sageox.ai/docs/cli/upgrade.md): Upgrade ox to the latest version
- [ox version](https://sageox.ai/docs/cli/version.md): Print version information
- [ox uninstall](https://sageox.ai/docs/cli/uninstall.md): Remove SageOx from this repository

## MCP
- [MCP overview](https://sageox.ai/docs/mcp.md): Use SageOx inside your AI tools via the Model Context Protocol.
- [Connect Claude to SageOx](https://sageox.ai/docs/mcp/claude.md): How to add SageOx as a custom connector in Claude Code and Claude Desktop before it appears in the Anthropic connector directory.
- [Connect ChatGPT to SageOx](https://sageox.ai/docs/mcp/chatgpt.md): Connect ChatGPT to one team for cited knowledge, keep decisions from saved chats with Undo, and receive enabled team updates in context.
- [Getting the most out of SageOx](https://sageox.ai/docs/mcp/getting-the-most.md): How to prompt your AI tool to use SageOx well, and what the interactive cards do.
- [Connect any MCP client](https://sageox.ai/docs/mcp/manual.md): Raw URL + canonical mcpServers JSON for any MCP-compatible client.

## Cookbooks
- [Cookbooks](https://sageox.ai/docs/cookbooks.md): Step-by-step workflow recipes for SageOx. Import Loom, Figma, and Cap recordings, and run AI agent factories with OpenClaw. Build team knowledge that compounds over time.
- [SageOx + Loom](https://sageox.ai/docs/cookbooks/loom.md): Import Loom walkthroughs into SageOx. Automatic transcription, keyframe extraction, and summarization turn your Loom recordings into searchable context for AI coworkers.
- [SageOx + Figma](https://sageox.ai/docs/cookbooks/figma.md): Import Figma design walkthroughs into SageOx. Automatic transcription and keyframe extraction turn your design rationale into context AI coworkers reference when implementing UI.
- [SageOx + Cap](https://sageox.ai/docs/cookbooks/cap.md): Use Cap for screen recordings with optimal export settings for SageOx. Full control over resolution, frame rate, and quality for fast uploads and accurate AI extraction.
- [SageOx + OpenClaw](https://sageox.ai/docs/cookbooks/openclaw.md): Run OpenClaw AI agent factories with full team context. Factory-spawned agents receive your team's conventions, decisions, and domain knowledge automatically.