Skip to main content
TRW
TRWGetting Started

Docs

Install TRW, choose your clients, and start with the workflow that compounds

TRW is the engineering operating layer that sits above your coding client. Install it once, choose the surfaces you actually use, and keep every session grounded in durable project memory, structured execution, and verified delivery.

Persisted learnings
1,251+
Repository tests
8,000+
Core package coverage
91%

1-line installer

Run the shell bootstrap first

It is still the fastest path into the gated beta and now sets up more than one client surface in the same repo.

shell bootstrap
curl -fsSL https://trwframework.com/install.sh | bash
  • Downloads the Python installer and authenticates when needed.
  • Lets you select more than one client surface for the repo.
  • Bootstraps the local TRW layer before you open your first session.

Client coverage

One repo can carry more than one client surface

TRW now supports Claude Code, Cursor IDE, Cursor CLI, OpenCode, Codex CLI, GitHub Copilot CLI, Gemini CLI, and Aider. The installer can wire one repo to several of them at once, so you can keep a terminal workflow, an editor workflow, and a lighter CI-friendly surface aligned from the same project state.

Claude CodeCursor IDECursor CLIOpenCodeCodex CLIGitHub Copilot CLIGemini CLIAider
Supported clients
8
Full ceremony profiles
4
Light ceremony profiles
4

What changes after install

Sessions stop resetting to zero

TRW persists the context you already paid to learn, keeps work inside a defined lifecycle, and records validation instead of asking you to trust narration.

  • Knowledge that compounds

    Session 50 starts with the decisions, fixes, and gotchas that earlier sessions already paid to discover.

  • Right-sized ceremony

    Quick fixes stay fast. High-risk changes get checkpoints, validation, review, and durable handoff.

  • Verification before narration

    TRW treats build results, review gates, and persisted state as the definition of done.

  • Recovery after interruption

    Checkpoints and run state survive context compaction, interrupted sessions, and handoffs.

Without TRW vs With TRW

See how work changes once project state survives the session

Without durable context, every session spends energy reconstructing state. With TRW, the repo keeps the learnings, checkpoints, and validation history in play.

Without TRW
  • Learnings lost every session
  • No checkpoints, rework from scratch
  • Skip tests, ship bugs
  • No quality gates, defects cascade
  • Context evaporates on compaction
With TRW
  • Knowledge compounds across sessions
  • Checkpoints survive interruption
  • Automated validation gates
  • Quality audit before delivery
  • Discoveries persist permanently

Install flow

From request access to first session

  1. 1

    Request access

    TRW currently rolls out through a gated beta. Start with quickstart if you are evaluating fit, or join the waitlist if you want access.

  2. 2

    Run the bootstrap

    The shell bootstrap installs trw-mcp, authenticates if needed, downloads the Python installer, and starts guided setup.

  3. 3

    Choose your clients

    First-time installs now let you select every client surface you want TRW to configure in this repo — not just one.

  4. 4

    Start your first session

    Open any configured client, call trw_session_start(), and finish with trw_deliver() so the context keeps compounding.

What gets added to your repo

The local operating layer lands in the repo

  • .trw/config.yaml

    Project-local TRW configuration, including your selected target_platforms.

  • .trw/

    Runs, learnings, analytics, and the local operating layer that survives session boundaries.

  • Client-specific instruction surfaces

    Examples: CLAUDE.md, .cursor/rules/, .codex/INSTRUCTIONS.md, GEMINI.md, or .github/copilot-instructions.md.

Supported clients

Pick the surfaces that match how you work

Use Full profiles when you want translated hooks, skills, and broader automation. Use Light profiles when you want a smaller surface area, headless-friendly defaults, or a stricter CLI boundary.

8 profiles4 full4 light

Full surface

Full Ceremony Profiles

Use these when you want deeper translation into the client: broader instruction surfaces, richer automation, and the most complete TRW shape.

4 profiles

Claude Code

Full

Best-understood end-to-end profile for local, hook-heavy TRW workflows.

Best fit
Users who want the fullest TRW surface in one CLI
Automation
Deepest local hook, skill, and agent-team surface

TRW writes

CLAUDE.md.claude/hooks/.mcp.json

Cursor IDE

Full

Full TRW surface tuned for Cursor’s IDE-native rules and automation.

Best fit
Interactive editor-first workflows inside Cursor
Automation
IDE rules plus translated hooks, commands, skills, and subagents

TRW writes

.cursor/rules/.cursor/hooks/.cursor/mcp.json

GitHub Copilot CLI

Full

Full TRW support translated into Copilot’s GitHub-first surfaces.

Best fit
GitHub-native repos adopting agent workflows and path-scoped guidance
Automation
Repo instructions, path-scoped guidance, hooks, agents, and skills

TRW writes

.github/copilot-instructions.md.github/instructions/.github/agents/

Gemini CLI

Full

Full TRW support adapted to Gemini’s native instruction and subagent surfaces.

Best fit
Very large-context sessions and Gemini-native agent work
Automation
Gemini-native instructions, MCP config, and subagents

TRW writes

GEMINI.md.gemini/settings.json.gemini/agents/

Light surface

Light Ceremony Profiles

Use these when you want a smaller footprint, explicit CLI boundaries, or headless-friendly defaults without dropping durable project memory.

4 profiles

Cursor CLI

Light

A lighter profile for headless Cursor runs where explicit permissions matter.

Best fit
cursor-agent, CI, and scripted terminal workflows
Automation
Headless-safe permissions and CLI hook subset

TRW writes

AGENTS.md.cursor/cli.json.cursor/mcp.json

OpenCode

Light

Instruction-first TRW integration with OpenCode-native commands and agents.

Best fit
Lean terminal workflows with curated TRW surfaces
Automation
Curated commands, agents, and instruction-first guidance

TRW writes

opencode.json.opencode/commands/.opencode/agents/

Codex CLI

Light

A light TRW profile shaped around Codex’s workflow and context constraints.

Best fit
Codex users who want tighter context and lighter ceremony defaults
Automation
Codex-specific config, agents, curated skills, optional hooks

TRW writes

.codex/config.toml.codex/INSTRUCTIONS.md.codex/agents/

Aider

Light

A light TRW profile for users who want compounding context without heavy scaffolding.

Best fit
Minimal terminal workflows that still need durable project memory
Automation
Instruction-first, low-ceremony integration

TRW writes

AGENTS.md.aider/instructions.md