Paseo

Paseo is an orchestration layer: the desktop app, mobile, web, and the paseo CLI all exist, but it ships no agent of its own and only runs coding CLIs you have already installed and signed in to (Claude Code, Codex, OpenCode, Pi, and so on). So connecting aicentos in Paseo really means making the hosted CLI go through aicentos.

PrerequisitesCopy anchor link

First install Paseo and have at least one underlying CLI ready:

npm install -g @getpaseo/cli
paseo

Download the desktop and mobile apps from the official site. Note that the Docker image contains no agent CLI, so a container deployment has to install them yourself.

Configuration to fill inCopy anchor link

Paseo providers are defined under agents.providers.<id> in ~/.paseo/config.json, with the fields extends, label, env, and models. What it supports is injecting environment variables into the underlying CLI, and the official examples all use the Anthropic-compatible protocol:

Setup stepsCopy anchor link

Edit ~/.paseo/config.json:

{
  "agents": {
    "providers": {
      "aicentos-claude": {
        "extends": "claude",
        "label": "aicentos",
        "env": {
          "ANTHROPIC_BASE_URL": "https://aicentos.com",
          "ANTHROPIC_API_KEY": "sk-your-API-Key"
        }
      }
    }
  }
}

Reload after the change:

paseo reload

Then set the session's provider to aicentos in Paseo.

If you are hosting an OpenAI-protocol CLI (such as Codex), replace env with that CLI's own variables (OPENAI_BASE_URL, OPENAI_API_KEY) and use https://aicentos.com/v1 as the Base URL.

TestCopy anchor link

paseo run --provider aicentos-claude "Introduce yourself in one sentence"

A response means it works. You can also create a session directly in the desktop app and see whether the model label shows the provider you configured.

NotesCopy anchor link

• Paseo has no model configuration of its own. It is normal that there is no Base URL input box; look in the underlying CLI or in env instead.
• The official docs only give Anthropic-compatible field examples; there is no written rule for OpenAI-compatible endpoints, so follow the underlying CLI's variable names and trust what you measure.
• env overrides the sign-in state already saved by the underlying CLI; a wrong value also breaks sessions that used to work, so prefer adding a new provider rather than editing the default one.
• You must complete authentication in the underlying CLI first; Paseo does not sign in on your behalf.

Related linksCopy anchor link

• Paseo custom provider docs
• paseo repository