Skip to content

All commands

chimera solve

Tier-2: autonomously solve a task with plan + verify-or-revert. Requires a key.

Arguments

  • TASKstr

    The task to solve autonomously (omit with --approve/--deny).

Options

  • --verifystr

    Verification command (exit 0 == success).

  • --workspace, -wstrdefault: '.'

    Workspace root.

  • --model, -mstr

    Override the model slug.

  • --max-attemptsintdefault: 3

    Max verify-or-revert attempts.

  • --max-stepsintdefault: 8

    Max tool-calling steps per attempt.

  • --no-planboolean

    Skip the planning step.

  • --no-managerboolean

    Skip Manager review.

  • --rubricboolean

    Manager reviews via the cascade rubric.

  • --fuseboolean

    Route deep-reasoning turns through fusion.

  • --cascadeboolean

    Tiered routing: weak -> gate -> mid -> gate -> fusion (cheap by default).

  • --guardboolean

    Gate tool calls through the governance kernel.

  • --allow-toolsstr

    Per-session allowlist: only these tools (comma-separated).

  • --deny-toolsstr

    Per-session denylist: drop these tools (comma-separated).

  • --taintboolean

    Track a capability ledger + review execution of tainted input.

  • --collectbooleandefault: True

    Record trajectories for opt-in model evolution.

  • --no-rememberboolean

    Don't auto-write a long-term memory fact on success.

  • --no-evolve-skillsboolean

    Don't auto-propose a learned skill when a task recurs.

  • --isolateboolean

    Run in an isolated git worktree; changes copied back only on success.

  • --explorerboolean

    Give the agent an isolated Context Explorer for repo search (FastContext-style).

  • --subagentsboolean

    Give the agent spawn_subagent to delegate subtasks to isolated subagents.

  • --repo-mapboolean

    Prepend a structural map of the workspace (files + top-level symbols) to the agent's context.

  • --progress-ledgerboolean

    After a failed attempt, run a structured self-check that steers the retry (helps weak models).

  • --checklistboolean

    Extract the task's atomic requirements and grade each attempt's coverage (catches dropped constraints).

  • --gen-testsboolean

    With no --verify: generate executable pytest grounded in the task's requirements and use it as the gate (catches wrong code the coverage grade rubber-stamps).

  • --profilestr

    Model-role profile: economy | balanced | max. Puts a different model on each role (explore/plan/edit/review) drawn from the tier ladder. Routing is NOT yet shown to improve outcomes — see bench/role_routing/PREREGISTRATION.md.

  • --role-modelsstr

    Per-role model overrides: 'edit=vendor/slug,plan=vendor/other'. Roles: explore, plan, edit, review. Merges over --profile; a role left unset keeps --model. `verify` is not a role here — it runs a command and has no model to choose.

  • --write-regionstr

    Comma-separated globs the file-writers may touch (e.g. 'src/**,*.py'). A write outside is refused — blocks an injected instruction from rewriting an unrelated file.

  • --probe-logboolean

    Log (arm, proxy=manager-judgment, reward=verified) per attempt to <home>/probe.jsonl for PROBE best-arm selection (see `chimera probe-select --from-log`). Needs --verify + a manager.

  • --normalize-taskboolean

    Reshape a long, rambling bug-report task into a salient-facts-first form (location/repro/expected-vs-actual/fix-hint) before planning. No-op on non-bug or short tasks.

  • --playbookboolean

    Inject the stored ACE strategy playbook into context, then curate it from this run's outcome (closed loop).

  • --skill-cardsboolean

    Read learned skill cards back into context (the learn->use loop). Default follows settings.skill_cards; this overrides it per run.

  • --agreementintdefault: 1

    With --fuse: sample K cheap answers per turn; escalate to fusion when they disagree (free confidence signal).

  • --strong-verifystr

    Model slug of a stronger, independent judge that grades hard-turn (retried) results before accepting them.

  • --replanboolean

    On a stall, rebuild the plan from accumulated failure causes (dual-ledger) instead of just nudging.

  • --diff-feedbackboolean

    Show a failed attempt its own reverted diff, as a path not to retake.

  • --keep-workspaceboolean

    On failure, leave the last attempt's edits on disk for an external grader (don't revert).

  • --require-diffboolean

    Fail an attempt that changed no file — for code tasks, an explanation is not a fix.

  • --stagnation-fuzzyboolean

    Match repeated-failure signatures approximately, not byte-identically.

  • --contractstr

    Machine-checkable success clauses, comma-separated: file_exists:PATH | file_contains:PATH:REGEX | answer_matches:REGEX.

  • --streamboolean

    Print live progress events (attempt/result/status) as the run proceeds.

  • --threadstr

    Checkpoint this run under a thread id; re-run with the same id to resume after a crash.

  • --pause-on-taintboolean

    Pause for human approval before finalizing a run that consumed untrusted content (needs --thread).

  • --approvestr

    HITL accept: finalize a paused run as-is, by thread id (no task needed).

  • --denystr

    HITL ignore: discard a paused run by thread id (no task needed).

  • --respondstr

    HITL respond: resume a paused run by thread id with --feedback guidance.

  • --feedbackstr

    Guidance for --respond (fed back so the run tries again).

  • --editstr

    HITL edit: finalize a paused run with the corrected --answer, by thread id.

  • --answerstr

    The human-corrected answer for --edit.