skip to content
// AI · Dev tooling

Construct

Construct is not a new chat app and not a swarm of specialist personas. It is a capability-aware layer bound to one project: constitution, sources, skills, workflows, and a permission lattice. You keep working in the host you already use; Construct remembers what is true, what must not be violated, and which decisions are still yours.

taglineA project-bound operating layer for the agent host you already use.status3.0.0-alpha · dogfood · under cutovertagsOpen source · CLI · MCP · TypeScript
// try it

Three commands.

  1. 01

    Install the alpha CLI

    npm install -g @geraldmaron/construct@alpha
  2. 02

    Bind a project (example: Cursor)

    cd ~/your-project && construct init --client=cursor
  3. 03

    Check the binding

    construct status && construct doctor
The intent

Why it exists

I build Construct in the open as dogfood for how I actually work with agent hosts. The alpha line is under architectural cutover — nothing is promised stable — and the bar is honesty about limits: legal and licensed judgments stay research and preparation, never advice or sign-off.

The shape

Bound to the project, not the chat

  • 01

    construct init writes .construct/ (project, constitution, sources, registry lock — committed) and a runtime database under .construct/state/ (ignored). It reads the repo, proposes a profile with provenance, and plants the operational skill into your host.

  • 02

    Proposed statements wait in construct inbox until you confirm or retire them. Nothing inferred becomes fact on its own.

  • 03

    In session you answer questions, remember constraints in your wording, manage outcomes through resolved workflows, or define standing outcomes an external clock can fire. The CLI stays for setup, inspection, scripting, and recovery.

Trust

Permissions that stay narrow

  • 01

    Every action sits on a tier from observe and draft up through project write, external write, destructive, and licensed judgment. Denials name what failed and the smallest step-up.

  • 02

    Approvals cover one tier, one target, one workflow, one executor, and they expire. Standing grants and break-glass are scoped the same way — wildcards never cover destruction, and licensed judgment is never Construct's to take.

The host

Work stays where you are

Construct never switches hosts or spends through another executor because one is installed. Claude Code, Cursor, VS Code, and OpenCode wire by project config; Codex and similar hosts can take the skill and point at construct serve. A headless runner exists only when you configure one, and it cannot decide, grant, remember, or finalize on its own.

Source, issues, and the actual code.