# ox config (/docs/cli/commands/config)



ox config [#ox-config]

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

Usage [#usage]

```bash
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 [#interactive-mode]

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

Available 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 [#priority-chain]

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

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

Examples [#examples]

List all settings [#list-all-settings]

```bash
ox config list
```

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

Get a specific setting [#get-a-specific-setting]

```bash
ox config get session_recording
```

```
session_recording = manual

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

Set at user level [#set-at-user-level]

```bash
ox config set telemetry off
```

Set at repo level [#set-at-repo-level]

```bash
ox config set session_recording auto --repo
```

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

Set at team level [#set-at-team-level]

```bash
ox config set murmuring auto --team
```

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

Clear an override [#clear-an-override]

```bash
ox config unset session_recording
ox config unset session_recording --repo
```

Subcommands [#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 [#flags]

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

Related commands [#related-commands]

* [ox status](/docs/cli/status) — View current configuration state
* [ox init](/docs/cli/init) — Initialize a project with default settings