Connect a repository
Connecting a repository links your codebase to SageOx, enabling AI context injection and team knowledge sharing. After connecting, every AI coworker session in that repo starts with your team's conventions, decisions, and domain knowledge.
Connect in 30 seconds
That's it. Your repo is now connected.
First time using SageOx? Run ox login first to authenticate. See Getting Started for the full setup.
What happens when you connect
When you run ox init:
- Team Context syncs — Your team's shared knowledge syncs locally
- Ledger activates — Code work history and session artifacts can be tracked
- AI context enabled — Claude Code and other AI coworkers can receive team context via
ox agent prime - Hooks configured — Claude Code automatically runs context injection on startup
Prerequisites
- A git repository with at least one commit
- A SageOx account (sign up free)
- The ox CLI installed (
curl -sSL https://raw.githubusercontent.com/sageox/ox/main/scripts/install.sh | bash)
Team vs personal scope
When connecting, you choose who can access the repo's knowledge:
| Scope | Who can access | Use case |
|---|---|---|
| Team | All team members | Shared projects, production codebases |
| Personal | Only you | Side projects, experiments, learning |
To connect to a specific team:
If you don't specify a team, ox init prompts you to choose or create one.
Verify your connection
You should see green checkmarks:
How AI coworkers use the connection
Once connected, Claude Code automatically receives your team's context:
- You start Claude Code with
claude - Claude Code runs
ox agent primeon startup (configured automatically) - Your AI coworker receives Team Context — conventions, decisions, domain terms, current work
- Every session starts informed, not from scratch
No manual priming needed. The connection handles it.
Connect multiple repositories
Each repository is connected independently. Run ox init in each repo you want to connect:
All repos can share the same team, giving your AI coworkers consistent context across your stack.
Disconnect a repository
To disconnect:
This removes local configuration. The repository record stays on SageOx but becomes inactive.
Troubleshooting
"Not a git repository"
Initialize git first:
"Already initialized"
Remove the existing configuration and reinitialize:
"Authentication required"
Run login first:
What's next
- Team Context — what's in the context your AI coworkers receive
- ox init reference — all flags and options
- ox doctor — diagnose configuration issues
- Claude Code integration — how context flows into coding sessions
Discussions | Capture Team Meetings for AI Context
Record team meetings, import Loom, Figma, and Cap videos, or upload existing recordings. SageOx transcribes discussions and extracts insights that inform your AI coworkers.
Video Import | Turn Recordings into AI-Accessible Knowledge
Import Loom, Figma, and Cap recordings into SageOx. Automatic transcription, keyframe extraction, and AI summarization turn video walkthroughs into searchable team knowledge.