omniroute-cli-cloud - SKILL.md Agent Skill

name: omniroute-cli-cloud description: Control OmniRoute cloud agents (OpenAI Codex, Devin, Jules) from the CLI — create tasks, track status, approve plans, send messages, and manage sources. Use when the user wants to automate cloud coding agent workflows via the terminal.

OmniRoute — CLI Cloud Agents

Requires the omniroute CLI. See CLI entry-point skill for install + global flags.

Supported agents

Agent	ID	Auth required
OpenAI Codex	`codex`	OpenAI API key
Devin	`devin`	Devin API key
Jules (Google)	`jules`	Google OAuth

Authenticate an agent

omniroute cloud codex auth             # Set / refresh Codex API key
omniroute cloud devin auth             # Set / refresh Devin API key
omniroute cloud jules auth             # OAuth login for Jules (opens browser)

List all agents

omniroute cloud agents                 # Show all configured cloud agents + status
omniroute cloud agents --json

Create a task

omniroute cloud codex task create \
  --title "Add OAuth to the auth module" \
  --prompt "Implement Google OAuth 2.0 login in src/auth/oauth.ts"

omniroute cloud codex task create \
  --title "Fix test failures" \
  --prompt-file ./task-description.md   # Read prompt from a file

Same syntax for devin and jules:

omniroute cloud devin task create --title "..." --prompt "..."
omniroute cloud jules task create --title "..." --prompt "..."

List tasks

omniroute cloud codex task list        # All Codex tasks (table)
omniroute cloud codex task list --json # JSON output

Get task details

omniroute cloud codex task get <taskId>       # Full task record
omniroute cloud codex task status <taskId>    # Status + progress only

Task status values: running, completed, failed, cancelled.

Approve a plan

Devin and Jules may pause for plan approval before writing code:

omniroute cloud devin task approve <taskId>   # Approve the proposed plan
omniroute cloud jules task approve <taskId>

Send a message to a running task

omniroute cloud codex task message <taskId> "Focus on the backend only, skip the UI"

List task sources (files touched)

omniroute cloud codex task sources <taskId>   # Files changed / created by the task

Cancel a task

omniroute cloud codex task cancel <taskId>
omniroute cloud devin task cancel <taskId>

Typical workflow

# 1. Authenticate
omniroute cloud codex auth

# 2. Create a task
TASK_ID=$(omniroute cloud codex task create \
  --title "Refactor auth module" \
  --prompt "Extract JWT logic to src/auth/jwt.ts" \
  --output json | jq -r '.id')

# 3. Poll status
omniroute cloud codex task status $TASK_ID

# 4. View touched files when complete
omniroute cloud codex task sources $TASK_ID

Errors

auth required → run omniroute cloud <agent> auth before any task commands
task create fails with 402 → agent billing limit reached; check your Codex/Devin/Jules account
task approve fails with 404 → task does not have a pending plan; check status first
jules auth browser flow fails → ensure Google account has Jules access; try omniroute cloud jules auth again