Optimus

Optimus is a task-execution agent runtime. It accepts problem reports, turns them into governed tasks, runs analysis or code changes against bound repositories, and returns status, results, and delivery outputs.

What It Does

• accepts manual submissions or external problem signals
• routes raw input into executable tasks
• runs analysis, fixes, validation, and delivery against registered repositories
• returns task status, structured results, review links, and notifications

How It Works

From a user view, the flow is simple: submit a problem, let Optimus run inside the target repository, validate the outcome, then consume the result and next action.

Quick Start

1. Install

npm install -g @sireai/optimus

2. Run setup

optimus setup

Setup creates the ~/.optimus runtime home, registers the first repository, configures Codex authentication, and records Jira, Sentry, and Feishu integration settings. When Jira and Sentry are both enabled, setup also stores the Jira project key used to auto-create Jira issues for Sentry-origin patch publication.

Supported Codex auth modes:

• openai_api_key
• codex_cli_login
• model_provider

3. Run a quick health check

optimus doctor --quick

4. Start the runtime

optimus start

submit sends work to the resident runtime, so start the service after setup.

5. Submit a task

optimus submit --title "Login crash" --description "Crash happens on startup with stack trace"

Common Commands

Base commands:

optimus --help
optimus version
optimus upgrade --check
optimus upgrade
optimus setup
optimus doctor --quick
optimus start
optimus submit --title "..." --description "..."

Task inspection:

optimus retry-task --task-id <taskId>
optimus cancel-task --task-id <taskId>
optimus task-status --task-id <taskId>
optimus task-result --task-id <taskId>
optimus delivery-status --task-id <taskId>
optimus task-events --task-id <taskId>

Repository management:

optimus repo add /path/to/repo --alias mobile-app
optimus repo list
optimus repo doctor

Jira intake:

optimus jira-submit-issue --issue-key MICARAPPI-13178 --repo mobile-app

Sentry intake:

optimus sentry-get-event --event-id 75d361c269bc40598c44e2eec75022f3
optimus sentry-submit-event --event-id 75d361c269bc40598c44e2eec75022f3 --repo mobile-app

More Docs

• Product PRD
• Architecture Design
• Development and Maintenance