Flame is an agent product with a Go Runtime, a terminal CLI, and one React application for Browser and Wails. Workflow providers decide Goal transitions and author Plan versions. Runtime owns their version-checked commits, durable Session and Run history, execution, and recovery. Clients own interaction and presentation. Scope supplies the agent framework and provider libraries.
| Path | Owner |
|---|---|
runtime/ |
Semantic core, HTTP delivery, local Go binding and Host contract generator |
apps/cli/ |
Scriptable flame command and interactive terminal |
apps/web/ |
Shared Browser/Wails product UI |
apps/desktop/ |
Native Wails host and macOS packaging |
packages/go-sdk/ |
Flame Go contracts, remote client and product-specific plugin author APIs |
packages/runtime-client/ |
@flame/runtime-client, generated wire projection and client |
packages/backend-sdk/ |
@flame/backend-sdk, TypeScript backend authoring API |
packages/component-sdk/ |
@flame/component-sdk, installed React component authoring API |
packages/local-runtime/ |
Process roots, token handoff and companion-distribution lookup |
packages/ui/, packages/icons/ |
Shared controls/tokens and authored optical icon masters |
plugins/ |
First-party backend/component/package sources and plugin build tools |
examples/plugins/ |
Independent authoring and component-composition consumers |
assets/brand/ |
Original brand artwork and guide |
design/branding/ |
Brand mark exploration history; shipped artwork lives in assets/brand/ |
tooling/, tooling/integration/ |
Workspace coordination and public product integration |
Read AGENTS.md and PROJECT_RULES.md. DEVELOPMENT.md owns the toolchain and command workflow. From this directory:
make setup
make generate
make check
make check-native
make check-authorUse make dev-web or make dev-desktop for the same Web product. make build-runtime, make build-cli and make package-desktop create deliveries under out/. A Runtime-hosting distribution includes its sibling frame-runner, plugins/ directory and pinned runtimes/node/<os>-<arch>/ companion. Ship these together; managed plugins do not search for a system Node executable. Desktop attaches to a Runtime rather than hosting plugin processes. Browser output is apps/web/dist; native embed staging is generated in apps/desktop/assets/web.
The repository root owns go.work and has no go.mod. Go SDK, local-runtime, Runtime, CLI, Desktop, first-party plugins, tooling and the independent Reviews backend own their Go dependency graphs. Root npm workspaces use one lock and one install. See workspace ownership for module boundaries.
Frame is consumed from the independently versioned github.com/Tangerg/frame
and @frame/sdk packages. There is no embedded framework module.
This integration is a breaking storage cutover. Runtime refuses a product root
containing an earlier flame-qimu.db or flame.db before creating new state.
Start the distribution with an explicitly selected fresh FLAME_HOME; localruntime.DataDirectory selects flame-frame.db
for Frame framework records and Flame business references in one SQLite database.
Retain the previous binary and data together for unresolved work. No historical
plugin-state reader or automatic conversion is supplied.
CLI defaults to a remote Runtime at http://127.0.0.1:17171. Select --runtime-mode embedded to host a Runtime in the CLI process. Remote connections use the base URL and FLAME_RUNTIME_TOKEN; a failed remote connection remains an error.
./out/cli/darwin-arm64/flame --runtime-url http://127.0.0.1:17171
./out/cli/darwin-arm64/flame --runtime-url http://127.0.0.1:17171 run --workspace /server/project "Review this project"Runtime appends and serves its generated /v2/rpc route. Provider configuration and filesystem paths belong to the Runtime host. Closing a client releases its transport and views; explicit cancellation is a Runtime command. Only the host that opened a Runtime owns shutdown.
To serve Web from that Runtime origin, build Web and set server.webDirectory (or FLAME_SERVER_WEBDIRECTORY) to the absolute apps/web/dist path. Static assets are public; RPC retains its token gate.