Skip to main content
Running AgentIDE | AgentIDERunning AgentIDE in the source-owned AgentIDE documentation.AgentIDEreferenceagentidereferenceevaluatoradopterdeveloperoperatorbuild-agent-systemsevaluate-beyond10x-productsreference

Running AgentIDE

These modes are generated from two ess-realization/1 declarations bound to the same exact AgentIDE ESS. The declarations, rather than this page, are the authority for implementation artifacts, semantic surfaces, attachment boundaries, availability, and runtime requirements.

Realization: agentide-standalone-linux​

Generated from agentide-standalone-linux for agentide v1 (sha256:509495079a366d767a747dbfcd22e419c28040b7ff32d15a1f284393168d16ab). Do not edit this file; change the realization declarations and regenerate it.

ModeInteractionAttachmentAvailabilitySupportStart
Model-backed local TUI (recommended)Agent loopIn processPublicPreviewagentide run --base-url ${AGENTIDE_BASE_URL} --model ${AGENTIDE_MODEL} --api-key-env MODEL_API_KEY
JSON CLIInvokeIn processPublicPreviewagentide snapshot --session ${SESSION_ID}
Local browser workbenchInvokeLoopbackPublicPreviewhttp://127.0.0.1:7788/
Projection-only local TUIInvokeIn processPublicPreviewagentide run

Model-backed local TUI​

Run the recommended interactive terminal workbench with the native Harness model loop.

  • Entrypoint: agent-tui
  • Implementation: released-linux-binary
  • Invocation: agentide run --base-url ${AGENTIDE_BASE_URL} --model ${AGENTIDE_MODEL} --api-key-env MODEL_API_KEY
  • Runtime requirements:
    • OperatingSystem linux — AgentIDE standalone effects target Linux.
    • EnvironmentVariable AGENTIDE_BASE_URL — Model API origin and prefix.
    • EnvironmentVariable AGENTIDE_MODEL — Exact model identifier.
    • Credential MODEL_API_KEY — API key read by name for each request and never journaled.

JSON CLI​

Invoke semantic intents from scripts or agent tool adapters and receive structured JSON.

  • Entrypoint: json-cli
  • Implementation: released-linux-binary
  • Invocation: agentide snapshot --session ${SESSION_ID}
  • Runtime requirements:
    • OperatingSystem linux — AgentIDE standalone effects target Linux.
    • EnvironmentVariable SESSION_ID — Identifier printed by session start.

Local browser workbench​

View the same durable projection in the embedded browser interface served on loopback.

  • Entrypoint: local-browser
  • Implementation: released-linux-binary
  • Invocation: http://127.0.0.1:7788/
  • Runtime requirements:
    • OperatingSystem linux — AgentIDE standalone effects target Linux.
    • Network loopback-7788 — Start agentide serve --session SESSION_ID before opening the URL.

Projection-only local TUI​

Inspect and operate the durable workbench without connecting a model.

  • Entrypoint: projection-tui
  • Implementation: released-linux-binary
  • Invocation: agentide run
  • Runtime requirements:
    • OperatingSystem linux — AgentIDE standalone effects target Linux.

Realization: agentide-hosted-devcenter​

Generated from agentide-hosted-devcenter for agentide v1 (sha256:509495079a366d767a747dbfcd22e419c28040b7ff32d15a1f284393168d16ab). Do not edit this file; change the realization declarations and regenerate it.

ModeInteractionAttachmentAvailabilitySupportStart
Hosted DevCenter workbench (recommended)Agent loopNetworkApproval requiredPreviewhttps://${DEV_CENTER_HOST}/workspaces/${WORKSPACE_ID}/agentide

Hosted DevCenter workbench​

Compose authenticated AgentIDE session projections into DevCenter; no public self-service endpoint is currently offered.

  • Entrypoint: devcenter-web
  • Implementation: devcenter-workbench
  • Invocation: https://${DEV_CENTER_HOST}/workspaces/${WORKSPACE_ID}/agentide
  • Runtime requirements:
    • EnvironmentVariable DEV_CENTER_HOST — Operator-provided DevCenter host; there is no public default.
    • EnvironmentVariable WORKSPACE_ID — Authenticated workspace identity.
    • Credential devcenter-session — Authenticated DevCenter session supplied by the hosting boundary.