Architecture

BIGGI is a VS Code extension backed by a bundled local runtime. The repository also contains shared libraries and hosted services used by the extension, but they are not separate end-user clients.

flowchart LR
  user["Developer in VS Code"]
  extension["BIGGI extension"]
  runtime["Bundled local runtime"]
  sdk["Generated SDK"]
  services["Model providers and optional BIGGI services"]

  user --> extension
  extension --> sdk
  sdk --> runtime
  runtime --> services

Product boundary

SurfaceResponsibility
VS Code extensionThe only installed and supported client
Embedded runtimeAgents, tools, sessions, persistence, providers, and local API
Generated SDKTyped communication between the extension and runtime
Shared UIChat, tool, diff, and settings components used by the extension
Hosted servicesOptional authentication, model routing, and supporting APIs

The runtime is compiled as part of extension packaging. It is not published as a standalone CLI, container, desktop app, or other IDE plugin.

Repository map

PackagePurpose
packages/biggi-vscode/VS Code extension and Agent Manager
packages/opencode/Embedded local agent runtime
packages/sdk/js/Generated runtime client
packages/biggi-ui/Shared extension UI components
packages/biggi-gateway/Authentication and provider routing used by the runtime
packages/biggi-telemetry/Extension and runtime telemetry
packages/biggi-game-runtime/Game-development runtime support bundled into BIGGI