Paseo with GetVibe models

Step-by-step Paseo setup with GetVibe: install the CLIs, drop in the ready config.json, avoid OAuth rebinding and verify spend.

Ready-made config

Download config.json

Built from our catalog on request: the API address, every published model with its context and output limit, and the recommended settings. It contains no key. Paseo passes env values to agents verbatim, so the file holds three PASTE-YOUR-GETVIBE-API-KEY-HERE placeholders — replace them with your key (steps below).

# macOS / Linux
mkdir -p ~/.paseo
curl -fsSL https://getvibeapi.com/api/integrations/paseo.json -o ~/.paseo/config.json

# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.paseo" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/paseo.json -OutFile "$HOME\.paseo\config.json"

Main model — gpt-6.1-sol: strong agentic coder with a large context at a moderate price; the bare id keeps cross-channel failover on.
Small tasks — deepseek-v4.1-flash: cheapest capable model with a 1M context, for titles, summaries, commit messages and compaction.
Streaming on, a 600-second request timeout, reasoning effort medium: a long reasoning answer takes minutes, and without streaming it runs into the wait limit.
Bare model IDs everywhere, no :suffix — that keeps automatic failover to a healthy channel on.

The catalog changes: when new models appear, download the file again. To keep only some models, add ?models= with comma-separated IDs to the URL.

Paseo is a graphical program for Windows and macOS. Install the app, then wire up the ready-made set of three GetVibe providers: Codex, Claude Code and OpenCode. A command line is only needed to install those three CLI tools — not to install or run Paseo itself.

1. Download and install Paseo Desktop

Open the official paseo.sh/download page and download the build for your system:

Parameter	Type	Description
`Windows`	installer	Usually Intel / x64. Run the downloaded Paseo-Setup-…-x64.exe and follow the installer.
`macOS`	DMG	Apple Silicon — for Macs with an M1/M2/M3/M4 chip or newer; Intel — for older Macs. Open the DMG and drag Paseo into Applications.

Launch Paseo from the Start menu on Windows or from Applications on a Mac. On first launch the app starts its own local daemon — there is no need to install Paseo separately via npm or to type the paseo command.

The download page also shows an npm option, but that is meant for servers and headless use. For this guide pick the Desktop block.

2. Install the CLIs for the providers you need

Paseo Desktop manages agents, but Codex, Claude Code and OpenCode themselves must be installed on your system. First install the current LTS version of Node.js from nodejs.org and reopen your terminal afterwards.

How to open a terminal

A terminal is a window where you type commands as text. To open one:

Parameter	Type	Description
`Windows`	PowerShell	Press Win + X → “Terminal” (or “Windows PowerShell”). Or: Win + R, type powershell, Enter.
`macOS`	Terminal	Press Cmd + Space, type Terminal and press Enter.

A window with a blinking cursor opens. Paste the commands below one at a time and press Enter after each. Pasting: right-click or Ctrl + V on Windows, Cmd + V on macOS. Installation takes 1–3 minutes; keep the window open while it runs.

If you only need one provider, you can install just its CLI. Node.js is needed for the commands below, but not for an already-installed Paseo Desktop.

Install all three CLIs:

npm install -g @openai/codex @anthropic-ai/claude-code opencode-ai

Check that the commands are available:

codex --version
claude --version
opencode --version

3. Connect the ready config.json

Download paseo-getvibe-config.json. Rename it to config.json and place it:

Parameter	Type	Description
`macOS / Linux`	path	~/.paseo/config.json
`Windows`	path	%USERPROFILE%\.paseo\config.json

The .paseo folder starts with a dot, so it is hidden by default. If you do not see it — do not create a new one, show hidden files instead:

Parameter	Type	Description
`Windows`	File Explorer	Paste %USERPROFILE%\.paseo into the Explorer address bar and press Enter — the folder opens even when hidden.
`macOS`	Finder	In Finder press Cmd + Shift + G, type ~/.paseo and press Enter. Show hidden files: Cmd + Shift + . (period).

If the .paseo folder does not exist yet — launch Paseo once and quit: it creates the folder itself. That is more reliable than creating it by hand.

The current Paseo Desktop has no dedicated “Import config” button. Placing the file under the exact name config.json in this folder is the standard way to load ready-made custom providers.

Windows may save the file as config.json.txt — the extension is hidden. In Explorer enable “View → Show → File name extensions” and verify the name is exactly config.json. This is the most common reason Paseo “does not see” the config.

The downloaded file is a complete minimal config. If Paseo is already set up, first save a backup and move only the three objects from agents.providersinto your existing file. Do not overwrite your own settings and providers.

4. Paste your API key

Open the file in a plain text editor: on Windows use “Notepad” (right-click the file → “Open with” → “Notepad”), on macOS use “TextEdit” (right-click → “Open With” → TextEdit). Do not open it in Word or Pages — they add formatting and the file stops being readable.

Replace all three occurrences of PASTE-YOUR-GETVIBE-API-KEY-HERE with your key from the GetVibe dashboard and save (Ctrl + S on Windows, Cmd + S on macOS). Paste the key between the quotes and keep the quotes. Do not publish the finished file or add it to Git.

On macOS in TextEdit, choose “Format → Make Plain Text” before editing, if available. Otherwise the file is saved as RTF and Paseo will not read it.

5. Remove stale logins

Codex may reuse a saved “Sign in with ChatGPT” login. Then a request could silently go straight to OpenAI. Claude Code with a GetVibe token picks it ahead of a saved subscription, but logging out also drops any old Apps Gateway session. Run both commands once:

codex logout
claude auth logout

OpenCode needs no logout: auth is stored separately per provider id, and the config explicitly chooses getvibe, its address and key. Do not run codex login --with-api-key with a GetVibe key.

6. Restart and verify everything in Paseo

Do not pick Auto-review for Codex (GetVibe) until you have updated the Codex CLI. With incompatible versions the agent fails before it even starts with the error unknown variant auto_review, expected user or guardian_subagent. The main fix: run npm install -g @openai/codex@latest in a terminal, then fully quit Paseo Desktop and reopen it. A single Restart daemon may not be enough to update an already-running app.

Reopen Paseo Desktop.
Open Settings → Host → Overview and press Restart daemon.
Open Settings → Host → Providers. The list should now show Codex (GetVibe), Claude Code (GetVibe) and OpenCode (GetVibe).
Return to the workspace and create an agent. In the bottom mode/permissions dropdown of the new agent form choose Default Permissions. It is a safe temporary pick for a beginner. Do not choose Auto-review. The Full Access option gives the agent execution without normal confirmation prompts and is not needed for this fix.
Send a short test: Reply with a single word: ready.

The Refresh button on a provider card refreshes the model list but does not replace Restart daemon after manually replacing the whole config.json.

7. Verify where the request went

Before the test, open Usage and requests in the GetVibe dashboard.
Send one test from Paseo and wait for the reply.
Refresh the page: a new row with the chosen model and charge should appear.

A reply in Paseo alone does not prove routing. If there is no new row in usage, stop and fix the config — do not continue with paid tasks.

Troubleshooting

“Command not found”

Close and reopen your terminal. If only one CLI is missing, rerun its install command from step 2. You do not need to reinstall Paseo Desktop.

Auto-review: unknown variant auto_review

Update Codex with npm install -g @openai/codex@latest, fully quit Paseo Desktop and reopen it. Until the compatibility issue is fixed, pick Default Permissions in the bottom mode dropdown. If an already failed session does not apply the new mode, create a new agent or tab and choose it before sending.

401 or a placeholder left in the file

Find and replace all three placeholder occurrences, check commas and quotes, then in Paseo open Settings → Host → Overview → Restart daemon.

Codex replies but no GetVibe spend shows

Run codex logout again, check codex login status, restart the daemon via Settings and pick only Codex (GetVibe).

Claude asks to sign in or shows Gateway

Run claude auth logout, check your key and restart the claude-getvibe provider.

OpenCode: “Provider not found: getvibe”

Make sure provider env has OPENCODE_CONFIG_CONTENT, the file was saved as real JSON, and restart the daemon via Settings.

Qwen3.8 missing or starts with an old error

Re-download the current paseo-getvibe-config.json: a previously saved copy does not update itself.
Fully quit Paseo Desktop. Replace the old config.json in the .paseo folder with the new file and paste your key into all three placeholders again. Do not send this file to support.
Open Paseo, run Settings → Host → Overview → Restart daemon and create a new agent: an old tab may keep using the previous model.
Choose exactly OpenCode (GetVibe), then Qwen3.8 Max Preview. Qwen does not belong to the Codex (GetVibe) provider.

If the error repeats, screenshot only the area with the provider name, model and the full error text. Cover or crop your key and the contents of config.json out. You can also copy a single error line from the agent window — without task messages, keys or environment variables.

Official sources

← PreviousOverview Next →Pi Agent