Syntax

Syntax connect

Wire a coding assistant to the local Bridge. Reversible.

syntax connect <agent> edits the named harness's own configuration to point at the local Bridge, and records the change so it can be undone.

Usage

syntax connect <agent>

Where <agent> is one of:

  • codex
  • claude-code
  • opencode
  • pi

The Syntax CLI is bundled with Syntax and doesn't take a connect step — it's available the moment Syntax is installed.

What happens

  1. Detects whether the named harness is installed.
  2. Locates its configuration file in the standard location for your OS.
  3. Backs up the configuration in a Syntax-managed ledger.
  4. Edits the configuration to point at the local Bridge.
  5. Applies any harness-specific normalizations.
  6. Records the change.

Disconnecting

syntax disconnect <agent>

Restores the harness's original configuration from the ledger and removes the ledger entry. If the harness has been removed since connection, disconnect cleans up gracefully.

Listing connections

syntax connect list

Shows every harness that's currently connected.

Multiple connections

You can connect multiple harnesses simultaneously. They share the same Bridge, the same active model policy, and the same approvals.

Detection failures

If the named harness isn't installed, syntax connect prints the upstream install instructions and exits without making changes. No ledger entry is created, so a subsequent install + connect works cleanly.

Where to go next