Stack

A local research-engineering cockpit — a Codex agent pane, GEPA prompt optimization, and Stack MCP for hosted Synth ops, in one terminal UI.

Stack runs locally: an OpenTUI cockpit with a Codex agent pane, OSS prompt optimization (GEPA via synth-optimizers), StackEval receipts, and Stack MCP for hosted Synth ops — SMR, Research Factory, optimizers, and WorkProducts — across dev, staging, and prod. It is built for research engineering first and works for everyday coding too.

Open source (MIT), public alpha. Install from source today; a first-party installer is planned.

Quickstart

Requirements

• Bun
• Codex CLI

Install from source

git clone https://github.com/synth-laboratories/stack.git
cd stack
make install
stack --version

First run

stack doctor   # check your environment
stack demo     # local, signed-out demo
stack          # launch the cockpit

To update: git pull && make install.

Hosted features (optional)

SMR, Research Factory, and hosted optimizers need a Synth API key from usesynth.ai/keys. Set SYNTH_API_KEY in your environment, or point stack.config.json at a key file via environments.*.authEnvFile. The local cockpit, demo, and OSS optimizers work without an account.

First-party installer (planned)

When release assets are live, the intended default path is:

curl -fsSL https://stack.usesynth.ai/install.sh | sh

Package-manager channels (Homebrew, npm) are deferred until they have their own install, update, and rollback proofs.

What's new — sidecar monitor (dev)

Long Codex goal runs produce a lot of output. Stack's monitor sidecar is a separate agent paired with your worker: it writes Sidecar events — short headlines and milestones — so you can skim progress without reading every tool call.

In /goal mode, Sidecar events is the default view (e). Press t for the monitor thread, a for the raw worker tape. See Usage § Stack Monitor.

Docs

• Usage & reference — controls, stackd API, monitor, workspace config, Stack MCP
• Synth productivity — OSS + hosted workflows
• Release process — channels, versioning, changelog
• Distribution — installer/download contract
• Telemetry — privacy posture and event allowlist
• Quality — lint, acceptance tiers, StackEval
• Security — reporting and credential handling

License

MIT