ox

module
v0.1.0 Latest Latest
Warning

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

Go to latest
Published: Feb 18, 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

Test it by having a different developer ask Claude about a decision made during the captured session.

โš™๏ธ 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

๐Ÿง  How Ox Fits In

Skills give agents hands. Ox gives agents taste and judgment.

Source Teaches Example
Coding agent (skills & plugins) HOW to do things "Run terraform plan before apply"
SageOx (team context) WHY to make decisions "Use spot instances for batch jobs"
SageOx (team context) STYLE conventions "Prefix all resources with env name"
SageOx (team context) WHEN to act "Review infra on cloud file changes"

๐Ÿค– Supported AI Agents

SageOx integrates with popular AI coding agents:

  • Claude Code - Automatic session hooks via .claude/ configuration
  • Other agents - Any agent that reads AGENTS.md or supports hooks

Run ox integrate to set up the integration for your preferred agent.

โš™๏ธ 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
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.
frictionapi
Package frictionapi provides types and client for the friction telemetry API.
Package frictionapi provides types and client for the friction telemetry API.
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.
notification
Package notification provides lightweight team context change detection.
Package notification provides lightweight team context change detection.
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 storage and management for agent session recordings.
Package session provides storage and management for agent 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.
tips
internal/tips/content.go
internal/tips/content.go
ui
uninstall
Package uninstall provides functionality for removing SageOx from repositories.
Package uninstall provides functionality for removing SageOx from repositories.
uxfriction
Package uxfriction captures CLI usage failures for analytics and provides "did you mean?" suggestions and auto-execution to improve user experience.
Package uxfriction captures CLI usage failures for analytics and provides "did you mean?" suggestions and auto-execution to improve user experience.
pkg
agentx
Package agentx provides coding agent detection, hook management, and configuration.
Package agentx provides coding agent detection, hook management, and configuration.
agentx/config
Package config provides configuration path resolution for agentx.
Package config provides configuration path resolution for agentx.
agentx/hooks
Package hooks provides hook management for coding agents.
Package hooks provides hook management for coding agents.
agentx/setup
Package setup provides initialization for the agentx package.
Package setup provides initialization for the agentx package.
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