Databricks Coding Gateway

coding-gateway is a lightweight launcher for running Codex, Claude Code, Gemini CLI, OpenCode, and GitHub Copilot CLI through Databricks.

Requirements

• Python 3.12+ — install with uv (uv.astral.sh)
• npm if tool CLIs need to be installed automatically

Installation

uv tool install git+https://github.com/databricks/coding-gateway

---

Usage

Just run the tool you want:

coding-gateway codex      # OpenAI Codex
coding-gateway claude     # Claude Code
coding-gateway gemini     # Gemini CLI
coding-gateway opencode   # OpenCode
coding-gateway copilot    # GitHub Copilot CLI

On first launch, coding-gateway will prompt for your Databricks workspace URL, authenticate, and configure that tool automatically. Subsequent launches go straight to the agent.

Pass flags directly to the underlying tool:

coding-gateway claude -r          # resume last session
coding-gateway codex --full-auto

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

To configure all tools at once:

coding-gateway configure

MCP servers (optional)

coding-gateway configure mcp

Add Databricks MCP servers to installed MCP-capable tools: Codex, Claude Code, Gemini CLI, OpenCode, and GitHub Copilot CLI. Options are shown in this order:

• Discovered external MCP connections
• Databricks SQL
• Managed Databricks MCPs (Vector Search, UC Functions, etc.)
• Custom MCP server URL

Discovered external MCP connections are listed directly. MCP auth uses a Databricks token that coding-gateway sets when launching each tool.

---

Other Commands

Command	Description
coding-gateway status	Show current workspace, base URLs, managed config files, and selected models
coding-gateway usage	Show AI Gateway usage summary
coding-gateway revert	Clear saved state and restore backed-up config files
coding-gateway configure --dry-run	Preview config files without writing them

Managed Local Files

coding-gateway manages these files:

File	Tool
~/.codex/config.toml	Codex
~/.claude/settings.json	Claude Code
~/.gemini/.env	Gemini CLI
~/.config/opencode/opencode.json	OpenCode
~/.copilot/.env	GitHub Copilot CLI

Existing files are backed up before being overwritten. coding-gateway revert restores backups.

Documentation

• Databricks AI Gateway overview
• Databricks AI Gateway coding agent integration
• Databricks CLI authentication
• Monitor AI Gateway usage

Contributing

Contributions are welcome.

Getting started

git clone https://github.com/databricks/coding-gateway
cd coding-gateway
uv sync

Development workflow

1. Create a feature branch off main.

2. Make your changes — keep them scoped to the requested behavior.

3. Run the test suite before pushing:

   uv run pytest          # unit tests
   uv run ruff check .    # lint

4. For end-to-end testing against a real workspace:

   CODING_GATEWAY_TEST_WORKSPACE=<db_workspace_url> uv run pytest tests/test_e2e.py -v

5. Open a pull request against main.

Adding a new agent

• Add src/coding_tool_gateway/agents/<name>.py with at least write_tool_config, launch, default_model, and validate_cmd.
• Register it in src/coding_tool_gateway/agents/__init__.py.
• Add focused tests under tests/.

Security

Please report security vulnerabilities to [email protected] rather than opening a public issue.

License

See LICENSE.md and NOTICE.md.