ox

module
v0.5.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 16, 2026 License: MIT

README ΒΆ

SageOx CLI (ox)

SageOx is agentic context infrastructure β€” we call it the hivemind. It makes architectural and product intent persistent and automatically available across humans and agents.

This initial version is intended for AI-native teams β€” teams that build products almost exclusively through prompts.

Sessions, ledgers, and team knowledge ensure your AI coworkers understand your project's patterns, security requirements, and architectural decisions from the start, making agentic engineering multiplayer by default.

Demo

SageOx CLI Demo

Install the CLI

Quick install (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

Set up ox in your repo

# cd into your code repo (e.g. ~/src/my-project)
cd ~/src/my-project
ox login

# one time setup, done ONCE per repo
ox init
# commit the changes in your repo, e.g. git commit -a -m 'SageOx init'

ox doctor
# ox doctor --fix may be needed in the alpha stage
ox status
# will give you the location of the team context and ledger repos

πŸ‘₯ Go to sageox.ai - Setup team

Go into your newly created team in SageOx and invite your coworkers by copying the invite in the upper right, displayed in Team Overview.

πŸŽ™οΈ Record discussions

Team discussions impacting the product are captured and transcribed in the app and the context is automatically available to Claude.

πŸ€– Capture sessions

ox-session capture the conversation between a developer and Claude so the decisions, patterns, and reasoning become available to the rest of the team.

pwd
/home/me/src/my-project
claude
/ox-session-start
<implement fizz buzz>
/ox-session-stop

πŸš€ Just Ask

Start your AI coworker in your repo and just ask:

  • "What decisions were made in the last coding session on this project?"
  • "Create a plan of work based on the SageOx team discussions from today."
  • "Look at my team's SageOx coding sessions from this week and teach me a really effective prompt that was used."

βš™οΈ How it works

  1. ox init creates a .sageox/ directory with shared team context for your project
  2. ox integrate sets up hooks so your AI coworker automatically loads context at session start
  3. Your AI coworker receives team context, security conventions, and architectural patterns
  4. Coworkers (human and AI) share context through ledgers and team knowledge
SageOx in Practice

Here's a real example from PR #4:

flowchart LR
    subgraph discuss ["πŸŽ™οΈ Ryan and Ajit Discuss"]
        A1["Captured in Team Context"]
    end
    subgraph implement ["πŸ€– Ajit Implements"]
        B1["Captured in Ledger"]
    end
    subgraph review ["πŸš€ Ryan Reviews"]
        C1["Code + Session + Transcript"]
    end
    discuss --> implement --> review

Ryan and Ajit discussed the daemon design in a recorded team discussion. Ajit then implemented it with Claude (session captured in the ledger). When Ryan reviewed the PR, he had the full picture β€” the original discussion audio, the implementation session, and the code.

βš™οΈ Configuration

SageOx looks for configuration in:

  1. CLI flags (--verbose, --quiet, --json)
  2. Environment variables (OX_* prefix)
  3. Config file (.sageox/config.yaml)

Directories ΒΆ

Path Synopsis
cmd
ox command
extensions
internal
api
badge
Package badge handles SageOx README badge detection and suggestion.
Package badge handles SageOx README badge detection and suggestion.
claude
Package claude provides utilities for discovering and parsing team Claude customizations.
Package claude provides utilities for discovering and parsing team Claude customizations.
cli
codedb/comments
Package comments extracts comments from source code using a character-level scanner configured by language-specific syntax families.
Package comments extracts comments from source code using a character-level scanner configured by language-specific syntax families.
codedb/symbols
Package symbols extracts symbol definitions and references from source code using tree-sitter for accurate AST-based parsing.
Package symbols extracts symbol definitions and references from source code using tree-sitter for accurate AST-based parsing.
daemon
Package daemon provides background sync operations for the ledger.
Package daemon provides background sync operations for the ledger.
daemon/testutil
Package testutil provides testing utilities for daemon functionality.
Package testutil provides testing utilities for daemon functionality.
doctorapi
Package doctorapi provides types and client for the cloud doctor API.
Package doctorapi provides types and client for the cloud doctor API.
endpoint
Package endpoint provides centralized SageOx endpoint URL management.
Package endpoint provides centralized SageOx endpoint URL management.
gitutil
Package gitutil provides shared git safety primitives used by both the daemon (pull/fetch) and CLI (push/commit) code paths.
Package gitutil provides shared git safety primitives used by both the daemon (pull/fetch) and CLI (push/commit) code paths.
identity
Package identity provides unified identity resolution for ox.
Package identity provides unified identity resolution for ox.
ledger
Package ledger provides functionality for managing project ledgers.
Package ledger provides functionality for managing project ledgers.
lfs
Package lfs provides a pure-HTTP client for the Git LFS Batch API.
Package lfs provides a pure-HTTP client for the Git LFS Batch API.
paths
Package paths provides centralized path resolution for all SageOx directories.
Package paths provides centralized path resolution for all SageOx directories.
repotools
Package repotools provides VCS abstraction for repository operations.
Package repotools provides VCS abstraction for repository operations.
session
Package session provides shared entry parsing utilities for session recordings.
Package session provides shared entry parsing utilities for session recordings.
session/html
Package html provides HTML session viewer generation.
Package html provides HTML session viewer generation.
signing
Package signing provides Ed25519 cryptographic signing and verification for embedded artifacts in the ox CLI.
Package signing provides Ed25519 cryptographic signing and verification for embedded artifacts in the ox CLI.
testguard
Package testguard provides test isolation primitives that prevent ox subprocesses from hitting production endpoints during tests.
Package testguard provides test isolation primitives that prevent ox subprocesses from hitting production endpoints during tests.
tips
internal/tips/content.go
internal/tips/content.go
tui
ui
uninstall
Package uninstall provides functionality for removing SageOx from repositories.
Package uninstall provides functionality for removing SageOx from repositories.
vtt
pkg
faultdaemon
Package faultdaemon provides a generic fault injection daemon for testing IPC.
Package faultdaemon provides a generic fault injection daemon for testing IPC.
scripts
sign-manifest command
sign-manifest signs ox artifacts and updates the release-signatures.json file.
sign-manifest signs ox artifacts and updates the release-signatures.json file.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL