Skip to content

README: document smart routing for Claude Code and fix flag names #283

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
masonc08 merged 1 commit into from
Aug 6, 2026
Merged

README: document smart routing for Claude Code and fix flag names #283

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 12 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,19 +44,21 @@ ucode codex --full-auto

All agents route through Databricks AI Gateway using your workspace credentials — no API keys required.

Codex intelligent routing is opt-in. Enabling it asks the AI Gateway router to select the
root-session model before launch and installs profile-scoped hooks that route future
`spawn_agent` calls. Codex may require one-time review of the installed hooks through `/hooks`.
Smart routing is opt-in for Codex and Claude Code. Enabling it asks the AI Gateway router
to select the root-session model before launch and installs profile-scoped hooks that route
future subagent calls. Codex may require one-time review of the installed hooks through `/hooks`.

```bash
ucode codex --enable-intelligent-routing
ucode codex --enable-smart-routing
ucode claude --enable-smart-routing
```

The setting persists for the current workspace. Disable it and remove only ucode's routing
The setting persists per workspace for each agent. Disable and remove only ucode's routing
hooks with:

```bash
ucode codex --disable-intelligent-routing
ucode codex --disable-smart-routing
ucode claude --disable-smart-routing
```

To configure all tools at once:
Expand Down Expand Up @@ -181,8 +183,10 @@ you to run `ucode <agent>` (existing agent sessions need a restart before the MC
| `ucode configure --workspaces https://first.databricks.com,https://second.databricks.com` | Configure workspaces without the interactive picker |
| `ucode configure --profiles DEFAULT` | Configure using existing Databricks CLI profiles (hosts come from `~/.databrickscfg`) |
| `ucode configure --profiles DEFAULT --use-pat` | Authenticate with the profile's personal access token — no browser login |
| `ucode codex --enable-intelligent-routing` | Enable AI Gateway routing for Codex sessions and subagents |
| `ucode codex --disable-intelligent-routing` | Disable routing and remove ucode's Codex routing hooks |
| `ucode codex --enable-smart-routing` | Enable AI Gateway routing for Codex sessions and subagents |
| `ucode codex --disable-smart-routing` | Disable routing and remove ucode's Codex routing hooks |
| `ucode claude --enable-smart-routing` | Enable AI Gateway routing for Claude Code sessions and subagents |
| `ucode claude --disable-smart-routing` | Disable routing and remove ucode's Claude Code routing hooks |
| `ucode configure --skip-validate` | Write configs without sending a test message through each agent |
| `ucode configure --agents claude --mcp system.ai.slack` | Configure an agent and register its Databricks MCP server(s) in one command |
| `ucode configure skills` | Register the skills MCP connection (utility tools only); no skills download |
Expand Down
Loading