Agents

Connect an agent to Inline as a private local bot, through MCP, or with an agent platform integration.

Choose a setup

• Add Inline to your agent

  Install the Inline plugin or skill for ChatGPT, Codex, Claude, and other agents.

• Local coding agents

  Run Codex, Claude, OpenCode, or Amp on your Mac and talk to it from Inline.

• Inline MCP

  Give an MCP client access to approved Inline spaces with OAuth consent.

• OpenClaw

  Add Inline as an OpenClaw channel.

• Hermes Agent

  Run Hermes from Inline chats and reply threads.

Local coding agents

On macOS, choose Set Up an Agent… from Inline's app menu or the Bots settings page. The wizard installs or updates the trusted Inline CLI, signs it in, finds every supported harness already installed on your Mac, and lets you choose which one to connect.

You can run the same unified flow in Terminal:

# Detect installed harnesses and choose interactively
inline agents setup

# Prompt-free setup for an agent or script
inline agents setup --target codex --non-interactive --json
inline agents setup --target hermes --non-interactive --json
inline agents setup --target openclaw --non-interactive --json

# Equivalent gateway shortcuts
inline setup hermes --non-interactive --json
inline setup openclaw --non-interactive --json

Supported harnesses are Codex, Claude, OpenCode, Amp, Hermes, and OpenClaw. Inline installs its own adapter or plugin, but it does not silently install those third-party runtimes. If a local coding harness needs no explicit folder, Inline uses your home directory; pass --folder to use a narrower workspace.

inline agents setup --target codex --folder /path/to/project

Read-only discovery is available for troubleshooting and app integrations:

inline agents discover --json --compact

The older inline setup codex|opencode|claude|amp commands remain supported. Codex is the primary local-bridge beta path; OpenCode, Claude, and Amp are experimental, while Hermes and OpenClaw use their own gateway integrations.

Check Codex, Claude, OpenCode, and Amp bridge health with:

inline bridge status

Hermes and OpenClaw run as gateways and have separate health checks:

hermes inline status --json --probe
openclaw channels status --channel inline --probe --json

If setup cannot finish

After target setup begins, the app and --json output identify the failed phase, stable error code, retry command, documentation link, and any work completed before the failure. Earlier validation and authentication failures provide a stable code and message; the app adds guide and retry recovery where possible. Setup is safe to retry. Inline asks before using --replace to repair a conflicting Hermes or OpenClaw configuration.

If the app finds an outdated Homebrew CLI, the wizard installs a compatible signed copy in another safe location without overwriting the Homebrew file. The standalone CLI menu continues to respect Homebrew ownership. If a harness installed through Volta, nvm/fnm, asdf/mise, pnpm, Bun, or a similar version manager is still missing, run inline agents discover --json --compact in Terminal and use the setup command there.

If a run reports status: "partial", it may have changed local or Inline-owned state; its changes array lists only work the CLI can confirm completed. Retry normally—the setup flow reconciles existing Inline-owned state instead of creating another bot.

For provider requirements, security boundaries, and current compatibility details, see the local agent bridge source.

Agent workflows

Install the official Inline skill after the CLI is ready:

inline skill install

The skill adds focused workflows for Inline MCP, the CLI, and local agents. See Add Inline to your agent for plugin, npx skills, and manual setup.