Harnesses

A harness is the runtime that executes your agent loop.

You can start a native harness session directly from the CLI without writing agent YAML:

omni claude
omni codex
omni pi

See Terminal for more launch commands.

To select a harness in agent YAML, swap one line:

executor:
  harness: claude-sdk

Tools, policies, prompts, and models stay the same across harnesses — only the runtime underneath changes.

Execution modes

Most coding agents can run in one of two modes:

• Direct — Omnigent drives the agent's model and tools itself. You get the full platform: web UI, streaming, contextual policies, persistent sessions, and mobile.
• Native TUI — Omnigent boots the vendor's own terminal UI in a pane and mirrors it back. You get the exact native experience, wrapped with Omnigent's collaboration and policy layer. These ids end in -native.

Next steps

• Supported Harnesses lists every available harness, its ids and aliases, execution modes, and support tier.
• Configuration covers vendor setup, custom ACP agents, runtime selection, and launch overrides.
• Community Harnesses explains how to package and register a new harness as a plugin.