Skip to main content
Every runtime is available. Select one in workflow frontmatter with runtime_key + method. Use Choosing a method to decide between api, sdk, and cli routes, and the Workflow Schema for every field you can set.
Runtime keyCategoryMethodsRecommended modelNeeds API key
anthropic-agent-sdkagentsdk, cliclaude-opus-4-7yes
gemini-antigravity-cliagentcli, sdkgemini-3.5-flashyes
gemini-genai-sdkchatsdkgemini-2.5-proyes
local-llmchatapigemma-4-e2byes
local-voicevoice— (desktop/voice surface)gemma-4-e2byes
openai-agents-sdkagentsdkgpt-5.5yes
openai-codex-sdkagentcligpt-5.5yes
openai-operatoragentapigpt-5.5yes
openai-realtime-apivoiceapigpt-realtime-2yes
openai-responses-apichatapigpt-5.5yes

anthropic-agent-sdk

Anthropic Agent SDK — Anthropic Claude Agent SDK / Claude Code When to use: Use when you want Claude Code style coding and shell-native agent behavior with Anthropic models. Capability flags: canParseVerdicts, canReview, supportsAdaptiveThinking, supportsBatchApi, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCacheControl, supportsCitations, supportsCloudTTS, supportsCodeInterpreter, supportsComputerUse, supportsContext1M, supportsDeveloperRole, supportsDocumentInput, supportsFileInput, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsReasoningEffort, supportsServiceTier, supportsSessionResume, supportsStreaming, supportsStructuredOutput, supportsThinkingBudget, supportsToolCalling, supportsWebSearch Knobs (set under harness_config.sdk_settings.anthropic):
KnobTypeWhat it does
thinking_typeenumAnthropic thinking mode.
thinking_budget_tokensnumberExtended thinking budget.
max_turnsnumberMaximum Claude agent turns.
permission_modeenumClaude tool approval mode.
Starter workflow (copy, then extend with snippets):
---
id: starter-anthropic-agent-sdk
version: 1.0.0
agent:
  runtime_key: anthropic-agent-sdk
  provider: anthropic
  model: claude-opus-4-7
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: anthropic-agent-sdk
        method: sdk
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: Anthropic Agent SDK

Plan, implement, verify; record evidence before finishing.

gemini-antigravity-cli

Google Antigravity 2.0 CLI — Google Antigravity CLI/SDK bridge When to use: Use for Google Antigravity 2.0 (I/O 2026-05-19) — local agentic coding loop via the agy CLI + google-antigravity Python SDK. 11 BuiltinTools (list_directory/search_directory/find_file/view_file/create_file/edit_file/run_command/ask_question/start_subagent/generate_image/finish), lifecycle Hook classes (runtime-enumerated; the SDK self-updates), 7-primitive policy DSL (allow/deny/ask_user/allow_all/deny_all/safe_defaults/workspace_only), MCP transports resolved from the installed SDK (stdio + streamable-http today; the vendor folded SSE reads into streamable-http), file-change + interval triggers, multimodal input (Image/Document/Audio/Video). Pairs with raw Gemini API/SDK in tandem. Capability flags: canParseVerdicts, canReview, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsDocumentInput, supportsFileInput, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsStreaming, supportsStructuredOutput, supportsThinkingBudget, supportsThinkingLevel, supportsToolCalling, supportsVideoInput, supportsWebSearch Knobs (set under harness_config.sdk_settings.gemini):
KnobTypeWhat it does
antigravity_modelenumSDK default “gemini-3.5-flash” (types.py:79). Other documented: “gemini-3.1-pro-preview” (types.py:125), image model “gemini-3.1-flash-image-preview” (types.py:80).
antigravity_thinking_levelenumThinkingLevel: MINIMAL | LOW | MEDIUM | HIGH (types.py:83).
antigravity_enable_subagentsbooleanCapabilitiesConfig.enable_subagents — allow start_subagent tool.
antigravity_enabled_toolsstring[]BuiltinTools allowlist (mutually exclusive with disabled_tools).
antigravity_disabled_toolsstring[]BuiltinTools denylist (mutually exclusive with enabled_tools).
antigravity_compaction_thresholdnumberToken count after which context window may be compacted.
antigravity_image_modelstringCapabilitiesConfig.image_model (default gemini-3.1-flash-image-preview).
antigravity_finish_schema_jsonstringJSON schema for the finish tool — drives structured_output().
antigravity_workspacesstring[]Workspace directories — file tools auto-restricted via policy.workspace_only().
antigravity_mcp_serversjsonMcpServerConfig union — transport discriminators resolved from the installed SDK (stdio + streamable-http today; the historic McpSseServer was removed by the vendor).
antigravity_vertexbooleanGeminiConfig(vertex=True) — Vertex AI backend via GCP ADC.
antigravity_sandboxbooleanagy --sandbox flag — terminal-restricted sandbox.
antigravity_add_dirstring[]agy --add-dir (repeatable) workspace directories.
antigravity_print_timeoutstringagy --print-timeout (default 5m0s).
antigravity_log_filestringagy --log-file override path.
antigravity_continuebooleanagy --continue/-c resume the most recent conversation.
antigravity_conversation_idstringagy --conversation <id> resume specific past conversation.
Starter workflow (copy, then extend with snippets):
---
id: starter-gemini-antigravity-cli
version: 1.0.0
agent:
  runtime_key: gemini-antigravity-cli
  provider: gemini
  model: gemini-3.5-flash
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: gemini-antigravity-cli
        method: cli
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: Google Antigravity 2.0 CLI

Plan, implement, verify; record evidence before finishing.

gemini-genai-sdk

Gemini GenAI SDK — Google GenAI SDK When to use: Use when you want Gemini native streaming, Google Search, code execution, or Vertex AI-backed deployment. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsDocumentInput, supportsFileInput, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsStreaming, supportsStructuredOutput, supportsThinkingBudget, supportsThinkingLevel, supportsToolCalling, supportsVideoInput, supportsWebSearch Knobs (set under harness_config.sdk_settings.gemini):
KnobTypeWhat it does
gemini_google_searchbooleanEnable built-in Google Search grounding.
gemini_code_executionbooleanEnable Gemini code execution.
gemini_use_vertex_aibooleanSwitch auth/transport to Vertex AI.
gemini_gcp_projectstringVertex AI GCP project.
gemini_gcp_locationstringVertex AI region.
Starter workflow (copy, then extend with snippets):
---
id: starter-gemini-genai-sdk
version: 1.0.0
agent:
  runtime_key: gemini-genai-sdk
  provider: gemini
  model: gemini-2.5-pro
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: gemini-genai-sdk
        method: sdk
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: Gemini GenAI SDK

Plan, implement, verify; record evidence before finishing.

local-llm

Local LLM — Local OpenAI-compatible LLM runtime When to use: Use for managed llama.cpp or a catalog-backed local endpoint covering the V1 local universe: llama.cpp, Ollama, MLX, and LocalAI. Sprint 07 signoff is llama.cpp only. Capability flags: canParseVerdicts, canReview, supportsCloudTTS, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsStreaming, supportsStructuredOutput, supportsToolCalling Knobs (set under harness_config.sdk_settings.local):
KnobTypeWhat it does
temperaturenumberSampling temperature.
max_tokensnumberMaximum generation length.
LOCAL_LLM_BASE_URLstringCatalog-backed local loopback base URL.
Starter workflow (copy, then extend with snippets):
---
id: starter-local-llm
version: 1.0.0
agent:
  runtime_key: local-llm
  provider: local
  model: gemma-4-e2b
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: local-llm
        method: api
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: Local LLM

Plan, implement, verify; record evidence before finishing.

local-voice

Local Voice — Desktop voice shell When to use: Use when you want local STT plus a provider-agnostic voice shell that can drive any text runtime. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsAudioOutput, supportsCloudTTS, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsRealtimeVoice, supportsStreaming, supportsStructuredOutput, supportsToolCalling Knobs (set under harness_config.sdk_settings.local):
KnobTypeWhat it does
voice_stt_backendenumSpeech-to-text backend.
voice_tts_backendenumText-to-speech backend.
voice_tts_voice_idstringPreferred voice identifier.
No turn-dispatch method: this runtime is used through desktop/voice surfaces, not workflow method selection.

openai-agents-sdk

OpenAI Agents SDK — OpenAI Agents SDK When to use: Use when you need declarative agents, hosted tools, typed handoffs, and guardrails in the OpenAI Agents SDK. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsAudioOutput, supportsBatchApi, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsCodeInterpreter, supportsCodexSandboxMode, supportsCodexThreadResume, supportsComputerUse, supportsCustomTools, supportsDeveloperRole, supportsDocumentInput, supportsFileInput, supportsHostedConnectors, supportsHostedContainer, supportsHostedConversations, supportsHostedFileSearch, supportsHostedMcp, supportsHostedSkills, supportsImageGeneration, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsPromptCacheKey, supportsPromptTemplate, supportsReasoningEffort, supportsServerAgentLoop, supportsServerCompaction, supportsServiceTier, supportsStreaming, supportsStructuredOutput, supportsToolCalling, supportsWebSearch Knobs (set under harness_config.sdk_settings.openai):
KnobTypeWhat it does
max_tokensnumberMaximum response tokens.
reasoning_effortenumReasoning effort for supported models.
openai_tool_profileenumHosted tool set selection.
Starter workflow (copy, then extend with snippets):
---
id: starter-openai-agents-sdk
version: 1.0.0
agent:
  runtime_key: openai-agents-sdk
  provider: openai
  model: gpt-5.5
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: openai-agents-sdk
        method: sdk
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: OpenAI Agents SDK

Plan, implement, verify; record evidence before finishing.

openai-codex-sdk

OpenAI Codex SDK — OpenAI Codex CLI/SDK bridge When to use: Use when you want Codex CLI autonomy, workspace-aware edits, and approval-driven coding loops. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsAudioOutput, supportsBatchApi, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsCodeInterpreter, supportsCodexSandboxMode, supportsCodexThreadResume, supportsComputerUse, supportsCustomTools, supportsDeveloperRole, supportsDocumentInput, supportsFileInput, supportsHostedContainer, supportsHostedSkills, supportsImageGeneration, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsPromptCacheKey, supportsPromptTemplate, supportsReasoningEffort, supportsServerAgentLoop, supportsServerCompaction, supportsServiceTier, supportsStreaming, supportsStructuredOutput, supportsToolCalling, supportsWebSearch Knobs (set under harness_config.sdk_settings.openai):
KnobTypeWhat it does
reasoning_effortenumReasoning effort passed through to Codex.
codex_sandbox_modeenumFilesystem sandbox mode.
codex_approval_policyenumCLI approval policy.
codex_config_jsonjsonRaw Codex TOML/CLI config overrides.
Starter workflow (copy, then extend with snippets):
---
id: starter-openai-codex-sdk
version: 1.0.0
agent:
  runtime_key: openai-codex-sdk
  provider: openai
  model: gpt-5.5
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: openai-codex-sdk
        method: cli
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: OpenAI Codex SDK

Plan, implement, verify; record evidence before finishing.

openai-operator

OpenAI Operator — OpenAI computer-use/operator path When to use: Use when you need computer-use style browser automation, screenshots, and hosted connectors through OpenAI tool primitives. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsAudioOutput, supportsAudioStreaming, supportsBatchApi, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsCodeInterpreter, supportsCodexSandboxMode, supportsCodexThreadResume, supportsComputerUse, supportsCustomTools, supportsDeveloperRole, supportsDocumentInput, supportsFileInput, supportsHostedConnectors, supportsHostedContainer, supportsHostedConversations, supportsHostedFileSearch, supportsHostedMcp, supportsHostedSkills, supportsImageGeneration, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsPromptCacheKey, supportsPromptTemplate, supportsRealtimeSIP, supportsRealtimeVoice, supportsRealtimeWebRTC, supportsReasoningEffort, supportsServerAgentLoop, supportsServerCompaction, supportsServerVAD, supportsServiceTier, supportsStreaming, supportsStructuredOutput, supportsToolCalling, supportsWebSearch, supportsWebhookDelivery Knobs (set under harness_config.sdk_settings.openai):
KnobTypeWhat it does
openai_connectorsstring[]Hosted connector IDs (Drive, Gmail, etc.); emitted as {type:mcp, connector_id} tools.
openai_connector_authorizationstringPer-connector OAuth access token map (connector id → token); required by the API for every connector tool.
computer_use_displaystringDisplay config {width,height,environment}; selects the older computer_use_preview tool (the current computer tool takes no display parameters).
tool_approval_modeenumApproval mode for computer-use actions.
openai_include_computer_call_imagebooleanInclude screenshot/image payloads in runtime events.
Starter workflow (copy, then extend with snippets):
---
id: starter-openai-operator
version: 1.0.0
agent:
  runtime_key: openai-operator
  provider: openai
  model: gpt-5.5
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: openai-operator
        method: api
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: OpenAI Operator

Plan, implement, verify; record evidence before finishing.

openai-realtime-api

OpenAI Realtime API — OpenAI Realtime API When to use: Use when you need low-latency audio or multimodal Realtime sessions with server VAD and voice output. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsAudioOutput, supportsAudioStreaming, supportsBatchApi, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsCodeInterpreter, supportsCodexSandboxMode, supportsCodexThreadResume, supportsComputerUse, supportsCustomTools, supportsDeveloperRole, supportsDocumentInput, supportsFileInput, supportsHostedContainer, supportsHostedFileSearch, supportsHostedMcp, supportsHostedSkills, supportsImageGeneration, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsPromptCacheKey, supportsRealtimeSIP, supportsRealtimeVoice, supportsRealtimeWebRTC, supportsReasoningEffort, supportsServerAgentLoop, supportsServerCompaction, supportsServerVAD, supportsServiceTier, supportsStreaming, supportsStructuredOutput, supportsToolCalling, supportsWebSearch Knobs (set under harness_config.sdk_settings.openai):
KnobTypeWhat it does
voicestringRealtime voice name.
modalitiesstring[]Realtime modalities to request.
turn_detectionenumServer VAD / turn detection strategy.
Starter workflow (copy, then extend with snippets):
---
id: starter-openai-realtime-api
version: 1.0.0
agent:
  runtime_key: openai-realtime-api
  provider: openai
  model: gpt-realtime-2
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: openai-realtime-api
        method: api
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: OpenAI Realtime API

Plan, implement, verify; record evidence before finishing.

openai-responses-api

OpenAI Responses API — OpenAI Responses API When to use: Use when you need the broadest OpenAI knob surface, structured output, hosted tools, background runs, and webhook delivery. Capability flags: canParseVerdicts, canReview, supportsAudioInput, supportsAudioOutput, supportsBatchApi, supportsBuiltinCodeExec, supportsBuiltinSearch, supportsCloudTTS, supportsCodeInterpreter, supportsCodexSandboxMode, supportsCodexThreadResume, supportsComputerUse, supportsCustomTools, supportsDeveloperRole, supportsDocumentInput, supportsFileInput, supportsHostedConnectors, supportsHostedContainer, supportsHostedConversations, supportsHostedFileSearch, supportsHostedMcp, supportsHostedSkills, supportsImageGeneration, supportsImageInput, supportsLocalRealtimeVoice, supportsLocalSTT, supportsLocalTTS, supportsMultiTurn, supportsPromptCacheKey, supportsPromptTemplate, supportsReasoningEffort, supportsServerAgentLoop, supportsServerCompaction, supportsServiceTier, supportsStreaming, supportsStructuredOutput, supportsToolCalling, supportsWebSearch, supportsWebhookDelivery Knobs (set under harness_config.sdk_settings.openai):
KnobTypeWhat it does
reasoning_effortenumReasoning effort for GPT-5/o-series models.
openai_backgroundbooleanBackground delivery via webhook.
openai_connectorsstring[]Hosted connector IDs.
openai_webhook_urlstringWebhook receiver for async delivery.
Starter workflow (copy, then extend with snippets):
---
id: starter-openai-responses-api
version: 1.0.0
agent:
  runtime_key: openai-responses-api
  provider: openai
  model: gpt-5.5
  role: worker
  task_template: "Run {{workflow_id}} for {{issue_ref}}."
  max_turns: 8
  routing_strategy: single_agent_routine
  single_agent:
    select: fixed
    candidates:
      - runtime_key: openai-responses-api
        method: api
budget:
  tokens: 60000
  wall_clock_minutes: 30
sandbox:
  workspace_write: true
tools:
  required:
    - fs.read
    - fs.write
---

# Starter: OpenAI Responses API

Plan, implement, verify; record evidence before finishing.