AlphaSwarm IDE

The AlphaSwarm IDE is a white-labeled Eclipse Theia 1.72 distribution + six AlphaSwarm compile-time extensions + an MCP-driven research copilot + a Perspective Arrow notebook renderer. It is the developer environment that sits next to (not replaces) the alphaswarm_client/ Vite operator UI.

SSoT pointers

This page is a thin pointer into the in-folder documentation that lives in alphaswarm_ide/. The canonical contracts are there.

Topic	Path
Overview + architecture	../alphaswarm_ide/README.md
Process + extension architecture	../alphaswarm_ide/docs/architecture.md
Per-extension reference	../alphaswarm_ide/docs/extensions.md
Canonical operator entrypoint (alphaswarm-cli ide)	../alphaswarm_ide/docs/cli-entrypoint.md
MCP integration (RFC 9728 + RFC 8707)	../alphaswarm_ide/docs/mcp-integration.md
Research Copilot (chat agent)	../alphaswarm_ide/docs/research-copilot.md
Notebook (Perspective MIME renderer)	../alphaswarm_ide/docs/notebook.md
Quant widgets (SpecAuthor / RunInspector / BacktestRunner)	../alphaswarm_ide/docs/quant-widgets.md
Deployment (local / single-pod K8s / Theia Cloud)	../alphaswarm_ide/docs/deployment.md
Phased roadmap (blueprint → AlphaSwarm)	alphaswarm-ide-roadmap.md

Hard-rule touchpoints

The AlphaSwarm IDE most-cited hard rules from ../AGENTS.md:

Rule	Owner	AlphaSwarm IDE consumer
2 (LLM gateway)	alphaswarm/llm/providers/router.py::router_complete	alphaswarm-research-copilot-ext's RouterCompleteClient
4 (canonical progress frame)	alphaswarm/tasks/_progress.py::emit	alphaswarm-quant-ext's AqpWsClient / RunInspectorWidget
22 (DataMCP boundary)	alphaswarm/data/mcp/	alphaswarm-mcp-bridge-ext's registrations
26 (CredentialResolver)	alphaswarm/credentials/resolver.py	Python notebook helpers (alphaswarm/notebook/helpers.py)
27 (IdentityProvider)	alphaswarm/auth/providers/	alphaswarm-ext's Auth0Service + new MCP bridge / copilot
45 (WorkloadRuntime)	alphaswarm_core/runtime/workload.py	alphaswarm-ext's halt fan-out + alphaswarm-cli ide doctor
47 (topology)	alphaswarm_controller/services/topology.py	alphaswarm-cli ide url --remote / detect / env
49 (MCP audience, RFC 8707)	alphaswarm/api/well_known.py + alphaswarm/api/mcp_audience.py	alphaswarm-mcp-bridge-ext's X-AlphaSwarm-MCP-Audience header
52 (step-up MFA)	alphaswarm/api/security_stepup.py	alphaswarm-ext's halt command + future copilot write tools

Canonical operator entrypoint

alphaswarm-cli auth login --device   # RFC 8628 device flow + OS keyring (rule 53)
alphaswarm-cli ide install           # one-time bootstrap
alphaswarm-cli ide build --dev       # yarn build:extensions + build:applications:dev
alphaswarm-cli ide start --open      # spawn Theia + open in browser
alphaswarm-cli ide doctor            # preflight checks

Full CLI reference: ../alphaswarm_cli/docs/index.md.

Boundary contract (mirrored from .cursor/rules/alphaswarm-ide.mdc)

• alphaswarm_ide/ extensions MUST NOT import from alphaswarm source. Cross HTTP only (AqpApiService) or via the DataMCP / CodebaseMCP HTTP surfaces.
• AlphaSwarm-specific behavior lives ONLY under alphaswarm_ide/theia-extensions/alphaswarm*/ (the six extensions). Don't sprinkle AlphaSwarm imports into core Theia files.
• The IDE is browser-target-only. The Electron app remains upstream-oriented and is NOT wired for AlphaSwarm in this release.
• The canonical entrypoint is alphaswarm-cli ide. Direct yarn invocations are inner-loop development only.

Vendored workspace retirement

The vendored test_theia/theia-ide workspace is byte-for-byte identical to alphaswarm_ide/ and can be retired. See ../alphaswarm_ide/docs/retire-vendored-workspace.md for the 5-step checklist.