SageOx CLI (ox)

The hivemind for human-agent teams. ox is the open-source CLI for SageOx. It loads your team's decisions, conventions, and session history into every coding agent session automatically, and records your sessions back to the shared context so the next coworker inherits them.

Today that context lives in scattered places: a meeting nobody recorded, a Slack thread three weeks deep, the head of whoever wrote the code. So humans repeat themselves and AI coworkers drift — rebuilding the same lost context every session. ox closes that gap. Decisions become shared memory; every session starts with the full picture instead of from zero.

Ask your coding agent what the team already figured out — even if it happened in a different agent, on a different machine, days ago.

One session, every moment that matters: it recalls a teammate's Codex work and your own prior Claude Code session, coordinates by murmuring and noticing a teammate already in the same files, and proposes a plan enriched with collisions, prior art, and who owns the area. All of it because every session is recorded to your team's shared, queryable history.

Latest Project Activity

Install

Homebrew (macOS / Linux):

brew tap sageox/tap
brew install ox

Install script (macOS / Linux / FreeBSD):

curl -sSL https://raw.githubusercontent.com/sageox/ox/main/scripts/install.sh | bash

From source:

git clone https://github.com/sageox/ox.git && cd ox
make build && make install

Verify with ox version.

Quickstart

cd ~/src/my-project     # your code repo
ox login                # authenticate with sageox.ai
ox init                 # one-time per repo: creates .sageox/
git add .sageox/ && git commit -m "initialize SageOx"
ox doctor               # diagnose (ox doctor --fix auto-repairs)
ox status               # auth, project, sync state, and daemon health

That's the whole setup. When an AI coworker runs ox agent prime at the start of a session, team context loads in automatically.

Recording is on by default. Once a repo is initialized, every new AI coworker session records automatically — there's nothing to start. Context only compounds when sessions are actually captured, and the payoff arrives a week later when a teammate's agent already knows what you decided today.

Secrets are stripped locally before anything uploads, and you can record manually or turn it off entirely — open the config editor and pick a recording mode:

ox config                # interactive editor; walks you through the modes

More detail in What gets recorded.

Then just ask your AI coworker things it couldn't have known on its own:

• "What did we decide about the daemon design, and who worked on it?"
• "Draft a plan from this week's team discussions."
• "Show me an effective prompt a teammate used on this repo recently."

What gets recorded

ox records coding sessions — the conversation between you and your AI coworker — so teammates and future sessions can learn from prior work. Here is exactly what leaves your machine, and what doesn't.

Recording is on by default. In an initialized repo, each new AI coworker session records automatically, and secrets are stripped locally before anything is uploaded.

What is captured

Your prompts, the agent's responses, and tool invocations — commands run, files read or written, and their outputs. File paths and diffs appear when your agent touches them.

Nothing is scraped passively. ox only captures what passes through the agent conversation itself.

What is redacted before upload

ox scans for secrets locally, before anything is stored or synced, and replaces them with [REDACTED_*] markers. There is nothing to configure.

Common credential formats are stripped automatically: cloud provider keys, service tokens (GitHub, GitLab, Slack, Stripe, npm, PyPI, and others), private keys, connection strings, auth headers, JWTs, and KEY=value assignments and shell exports. The full pattern list lives in internal/session/secrets.go — read it rather than trusting this summary.

⚠️ ox does not respect .gitignore for session capture. If your agent reads a file that contains a secret in a non-standard format, the redaction patterns above are the only filter. Avoid pointing your agent at .env files or credential files you would not want recorded.

Where it goes

Sessions are written to your local cache first — ~/.cache/sageox/ — then synced to your team's shared history, a git repository hosted on sageox.ai. Content is stored as LFS blobs; only metadata is git-tracked. In the current version, there is no local-only mode.

If you're offline or an upload fails, the session stays cached and ox doctor --fix retries it later. Cached sessions persist until uploaded or removed; there's no TTL or automatic pruning.

ox uninstall removes local session data and config. Sessions already synced are not deleted; add --local-only to skip notifying the server.

Enterprise self-hosted deployment isn't available today — talk to us if you need it.

Who can read it

Anyone on your team with access to that shared history. Scope is your team — not public, not shared across teams. Other than turning off recording for the session altogether, there are no finer per-session privacy controls: if you are on a team and you record, your teammates can read your sessions.

Turning it off, or recording manually

Recording starts automatically with each new AI coworker session. To end the active one:

ox session stop         # end the active session

To change the standing behavior — record manually, or not at all — open the config editor and choose a recording mode:

ox config               # interactive editor; walks you through the modes

All three modes govern what agent hooks do. ox session start always works — including under disabled, which stops automatic capture but is not a hard lock.

Your user-level setting overrides every repo and team setting. A disabled you set for yourself can't be undone by a repo you cloned or a team you joined.

Full detail: Privacy Policy · Terms of Service · Acceptable Use Policy

What you get

✅ generally available

How it works

ox init writes a .sageox/ directory that ties the repo to your team. From then on, ox agent prime injects team context — conventions, security requirements, architectural decisions, prior sessions — into each AI coworker before it writes a line. Coworkers, human and AI, share that context.

The payoff is multiplayer by default. When a discussion, an implementation session, and the resulting code all carry the same shared context, a reviewer opening the PR has the full story — the original reasoning, the session that built it, and the diff — without chasing anyone down.

Works with your coding agent

ox is agent-agnostic. The same recorded context is primed into, and queryable from, whichever agent your team uses.

✅ shipped · ➖ planned. Claude Code is the primary, most-tested target; see agent compatibility for the per-agent detail.

ox query, ox murmur, and ox status are plain CLI commands. They work from any agent — including ones with no adapter — as long as ox is on PATH.

Orchestrators

ox runs inside Block Buzz, Conductor, Gas City, and OpenClaw.

Agent and orchestrator names are trademarks of their respective owners; ox is compatible with, not affiliated with, them.

Configuration

Run ox config to open the interactive editor — it lists every setting with its current value and source, walks you through valid choices, and writes the right file for you. It's the recommended way to change anything, recording mode included.

ox config               # interactive settings editor (TUI)

Configuration resolves in this order, highest priority to lowest:

1. CLI flags — --verbose, --quiet, --json
2. Environment variables
3. User config — ~/.config/sageox/config.yaml · your machine, all repos
4. Repo config — .sageox/config.json · this repo, all users
5. Team config — from your team context · all repos on the team

User config beats repo and team config. That inverts the usual order, and it's deliberate: a repo or team can suggest a default, but it cannot override your personal preferences — recording mode, telemetry, and the like.

For scripting, ox config set <key> <value> writes the user file directly; add --repo to write the repo file instead.

Contributing

We're accepting contributions. Bug reports, fixes, docs improvements, and new agent adapters are all welcome — the ➖ rows in the compatibility table above are a good place to start.

Open an issue to report something or float an idea before you build it; send a pull request directly for small fixes.

ox is MIT licensed — see LICENSE.

Tools we love

ox stands on a lot of open source — see CREDITS.

We build ox in great company. These are the tools we rely on — and love — every day. Gratitude to the teams behind them, and to the wider developer community.