Skip to content
microvms-agentd

AgentSpec

View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in Claude CodeOpen in Cursor
@final
class AgentSpec

One agent to install: its name, and the two defaults a caller may override.

agent is "claude-code" or "codex"; anything else is refused by the core with the list. model defaults to the profile’s row (an inference-profile id), cli_version to the registry’s latest at build time; a pin changes the image name.

Constructor

Section titled “Constructor”
AgentSpec(agent: str, *, model: str | None = None, cli_version: str | None = None)

Properties

Section titled “Properties”

agent

Section titled “agent”
agent: str

"claude-code" or "codex".

cli_version

Section titled “cli_version”
cli_version: str | None

The pinned CLI version, or None for the registry’s latest at build time.

headless_command

Section titled “headless_command”
headless_command: str

The exact command prompt runs, with <TASK> where the quoted task goes.

model

Section titled “model”
model: str

The model this spec resolves to: the override, or the profile’s default.

Methods

Section titled “Methods”

claude_code

Section titled “claude_code”
@staticmethod
def claude_code(
    *,
    model: str | None = None,
    cli_version: str | None = None,
) -> AgentSpec

Claude Code with the profile’s defaults, or with overrides.

codex

Section titled “codex”
@staticmethod
def codex(*, model: str | None = None, cli_version: str | None = None) -> AgentSpec

Codex with the profile’s defaults, or with overrides.

Special methods

Section titled “Special methods”

__eq__

Section titled “__eq__”
def __eq__(other: object, /) -> bool

__repr__

Section titled “__repr__”
def __repr__() -> str

Provenance

Section titled “Provenance”

This page is generated from bindings/microvms-py/microvms.pyi by Griffe 2.3.0, run from site/scripts/gen-reference.mjs on every pnpm run sync, so an edit made here is overwritten by the next run.

To change the page, change the doc comment in the binding’s Rust source, then regenerate the declarations with mise run stubs. mise run stubs:check fails when the committed file no longer matches the source.