gateway-setuplisted
Install: claude install-skill JuLius5838/agw
# Agent Gateway — setup
Set up the local hybrid gateway. Native Claude requests retain Claude Code's saved
subscription; configured ChatGPT/Codex names route through a private per-developer
LiteLLM process.
## What to do
1. **Confirm prerequisites.** The developer needs `uv` installed and the native
Claude Code CLI on PATH. If `uv` is missing, point them to
https://docs.astral.sh/uv/ and stop.
2. **Run the bundled bootstrap.** It performs an ownership-aware preflight (it
refuses to overwrite an unrelated `agw`), installs/upgrades the pinned runtime
as a `uv` tool, and runs `agw setup`:
```bash
bash "${CLAUDE_PLUGIN_ROOT}/scripts/bootstrap.sh"
```
`agw setup` preserves user-edited registries. When an upgrade retires a
provider entry, setup first saves a one-time permission-restricted rollback
copy beside `models.yaml`. It enables the marked, reversible bare-`claude`
integration by default when the shell is detectable; pass `--no-shell` to
opt out.
3. **Enable the requested exact route.** Candidates ship disabled so installation
remains native-only until the developer makes a provider choice. Inspect them,
then enable the requested model/provider pair:
```bash
agw models list --all
agw setup --provider-owner gpt-5.6-sol=chatgpt
```
Use the exact name/provider requested by the developer; never silently pick a
candidate or enable every provider.
4. **Authenticate that provider** (interactive device flow — needs