ox config

View and modify ox configuration settings. Settings can be configured at user, repo, or team level with a priority chain.

Usage

ox config                              # Interactive TUI editor
ox config list                         # List all settings with values
ox config get <key>                    # Show setting with override chain
ox config set <key> <value>            # Set at user level
ox config set <key> <value> --repo     # Set at repo level
ox config set <key> <value> --team     # Set at team level
ox config unset <key>                  # Clear user-level override
ox config unset <key> --repo           # Clear repo-level override

Interactive mode

When run in a terminal without arguments, ox config launches an interactive TUI for browsing and editing settings.

Available settings

Setting	Values	Default	Description
`session_recording`	`disabled`, `manual`, `auto`	`manual`	When to record coding sessions
`github_sync`	`enabled`, `disabled`	`enabled`	Sync GitHub PRs and issues
`github_sync_prs`	`enabled`, `disabled`	`enabled`	Sync GitHub pull requests
`github_sync_issues`	`enabled`, `disabled`	`enabled`	Sync GitHub issues
`murmuring`	`manual`, `auto`	`auto`	AI coworker murmur publishing
`telemetry`	`on`, `off`	`on`	Anonymous usage telemetry
`tips`	`on`, `off`	`on`	Show contextual tips
`context_git.auto_commit`	`on`, `off`	`on`	Auto-commit context changes
`context_git.auto_push`	`on`, `off`	`on`	Auto-push context commits
`attribution.commit`	text or `""`	—	Commit attribution text
`attribution.pr`	text or `""`	—	PR attribution text

Priority chain

Settings are resolved in this order (first match wins):

User (~/.config/sageox/config.toml) — Personal preferences
Repo (.sageox/config.toml) — Project-specific settings
Team (Team Context config) — Team-wide defaults
Default — Built-in fallback values

Examples

List all settings

ox config list

session_recording    manual     (user)
github_sync          enabled    (default)
murmuring            auto       (team)
telemetry            on         (default)

Get a specific setting

ox config get session_recording

session_recording = manual

Override chain:
  user:    manual  ← active
  repo:    (not set)
  team:    auto
  default: manual

Set at user level

ox config set telemetry off

Set at repo level

ox config set session_recording auto --repo

This adds the setting to .sageox/config.toml in the current repo.

Set at team level

ox config set murmuring auto --team

This updates the team context config, affecting all team members.

Clear an override

ox config unset session_recording
ox config unset session_recording --repo

Subcommands

Command	Description
`ox config list`	List all settings with current values and sources
`ox config get <key>`	Show a setting's value and override chain
`ox config set <key> <value>`	Set a configuration value
`ox config unset <key>`	Remove an override at a specific level

Flags

Flag	Description
`--repo`	Apply to repo-level config (`.sageox/config.toml`)
`--team`	Apply to team-level config

ox status — View current configuration state
ox init — Initialize a project with default settings

On this page