Product and engineering handbook · English · Verified against the repository on 8 September 2026
Enactive is a desktop workspace for AI agents. You describe an outcome, choose a workspace and a worker, and let the application plan and execute work through tools. It records the actions, decisions, outputs, and final outcome so that you can inspect what happened and repeat a task later.
This wiki covers the desktop application, its shared execution engine, the console host, and the separate remote-server preview. It describes current implementation behavior. Recommendations are identified as recommendations; incomplete features are identified where they affect a workflow.
Contents#
Application overview
Purpose, core concepts, interface, and supported workflows
02Architecture and execution
Components, planning, tool execution, review, evidence, and outcomes
03Getting started
Prerequisites, build commands, initial configuration, and a first run
04Running tasks in the desktop app
Manual tasks, template launches, approvals, staging, background work, and retries
05Console and unattended execution
Actual CLI syntax, configuration, reports, exit codes, and scheduling limits
06Templates
Library, built-ins, parameters, editing, JSON, success criteria, and Global versus Workspace
07Settings
Providers, Team, Phases, behavior toggles, persistence, and configuration scope
08Choosing models by phase and role
Model responsibilities, selection guidance, routing, recommended setups, and evaluation
09Operations and troubleshooting
History, logs, storage, MCP, remote preview, recovery, and common problems
Recommended reading paths#
- First-time user: Overview → Getting started → Running tasks → Templates.
- Configuring an AI team: Settings → Models and Phases → Running tasks.
- Automating repeated work: Templates → Console → Operations.
- Contributor: Architecture → Settings → Templates → Operations.
Essential distinctions#
| Concept | Meaning |
|---|---|
| Workspace | The folder in which a run operates |
| Task | The requested outcome; it can have several recorded attempts |
| Run | One attempt to carry out a task |
| Worker | A role with instructions, tools, an autonomy level, and a model policy |
| Provider | A configured model endpoint |
| Phase | A model responsibility: Plan, Execute, or Review |
| Template | A reusable task definition that resolves into a specification for one run |
| Global template | A template available across this user's workspaces |
| Workspace template | A project-local template that takes precedence over a Global template with the same ID |
Documentation boundaries#
The desktop and console share engine code but have different configuration roots. Desktop Providers, Team, Phases, and MCP settings do not configure the current console executable.
The remote server is a separate preview. It is not a working remote execution connection to the desktop application in this checkout.
Older design documents remain under Docs. Some describe historical states or intended behavior. When those documents disagree with current composition code, this wiki follows the code. Each detailed page includes implementation links for maintenance.
This wiki was prepared through source inspection and checks of documentation examples. It does not claim a live provider, GUI, or production deployment certification.