Concepts

A quick map of the moving parts.

Agents & loops

Every chat runs an agent loop on OpenRouter — stream a thought, call a tool, observe, repeat — until it answers. Tool calls render inline as they happen.

Sandboxes

Code execution and Forge jobs run in E2B sandboxes over the network. The Python executor returns stdout, stderr, and any captured charts (Plotly / matplotlib).

The Forge layer

Forge authenticates as a GitHub App. Per job it mints a short-lived, repo-scoped token and injects it into the sandbox; the agent pushes only feat/job-* branches.

Note

Everything is driver-swapped behind env-selected interfaces — business logic never imports a vendor SDK directly.