Skip to main content

​
Available Agents

Omnara supports three AI coding agents:

Claude Code

Default agentAnthropic’s Claude Code CLI with full integration support

Codex

Rust-basedFast, native Omnara integration built in Rust

Amp

Advanced parsingSophisticated terminal output parsing

​
Setting Default Agent

Save your preferred agent to avoid specifying --agent every time: 
# Set default agent and exit
omnara --set-default codex
The default is stored in ~/.omnara/config.json and used for all future sessions.

​
Switching Agents

Override the default agent temporarily: 
# Use Claude Code (even if codex is default)
omnara --agent claude

# Use Codex with custom name
omnara --agent codex --name "Backend Work"

​
Agent-Specific Features

  • Claude Code
  • Codex
  • Amp

​
Features

  • Permission prompt forwarding to dashboard
  • Git diff tracking per message
  • Session log parsing (JSONL format)
  • JSONL message streaming
  • Plan mode support

​
Requirements

# Verify Claude Code is installed
claude --version

​
Configuration

All standard Claude Code flags are supported when using Omnara.

​
Configuration File

Your default agent preference is stored in ~/.omnara/config.json: 
{
  "default_agent": "codex"
}
You can manually edit this file or use the --set-default flag.

​
Agent Selection Priority

When you run omnara, the agent is selected in this order:
  1. Explicit --agent flag (highest priority)
  2. Default from ~/.omnara/config.json
  3. Hardcoded default: claude (if no config exists)

​
Agent Display Names

Customize how your agent appears in the dashboard: 
# Set a descriptive name
omnara --agent codex --name "Feature Development"

# Use environment variable
export OMNARA_AGENT_DISPLAY_NAME="Code Review Bot"
omnara
Display names help you identify sessions when running multiple agents simultaneously.

Environment Variables

Configure agents with environment variables

Configuration Files

Learn about all configuration files