Documentation
Everything the engine does, written down
Install it, connect an agent, call the tools, author a workflow. Each page describes what the shipped engine does — when the engine changes, the page changes with it.
Getting started
- Install and run the engine
Download the CodyCody engine for your platform, activate it with your license key, and start the two servers your coding agent and browser connect to.
- Connect your coding agent
Add the engine to Claude Code, Codex or any MCP client over streamable HTTP, authenticated with an agent token you issue and can revoke.
MCP tools
- ccw_list
List the published workflows the engine can run, with the description and input schema each one declares.
- ccw_start
Start a workflow instance. The engine runs its own steps until one needs the agent, then returns that step's instruction.
- ccw_continue
Report the result of the current step and receive the next instruction. The same call completes an instruction, a decision, a shell command, a review and an approval gate.
- ccw_status
The current state of one workflow instance — status, current step, and progress through any task list.
- ccw_instance_list
List workflow instances, filtered by status or workflow, newest first.
- ccw_instance_logs
The execution log of one instance — every step started, completed, waited or failed, with the engine's notes.
- ccw_instance_cancel
Cancel a running instance. The reason is recorded in its audit trail.
- ccw_step_back
Rewind an instance to an earlier step when a step was answered wrongly. Rewinds engine state only, and reports what it could not undo.
- ccw_skill_list
List the reusable skills on the instance — standalone markdown procedures an agent can fetch and follow.
- ccw_skill_call
Fetch a skill's full instructions with every nested skill and instruction-file reference resolved, ready to follow.
Authoring workflows
- Execution model
A workflow is a directed graph run cooperatively by the engine and an agent. Design for that split — the engine decides what happens next, the agent does the work.
- Document format
A workflow is one JSON document — name, description, input schema, steps and transitions. The naming rules that templates depend on.
- Step types
The fourteen step types — what each one's config means, which ones the agent performs, and the contracts the engine enforces around them.
- Transitions
How steps connect, which steps branch, how loops are built, and the labelled transitions that task loops and reviews require.
- Template language
The {{dotted.path}} syntax that carries input, step results, task data and variables between steps — and the two places it behaves differently.
- Validation
What publish checks, and what it does not — the runtime failures an author has to prevent by hand.
- Instruction files and skills
Reusable prompt content that lives outside workflows — attached to steps, embedded by reference, or fetched by agents directly.
- Design guidelines
Eight rules for workflows that produce auditable results, terminate, and survive being run by an agent that remembers nothing between steps.
- Authoring over the API
From the Team tier, a coding agent can create, validate and publish workflows through the REST API with its agent token. Without a token the API refuses every request.
Packages
- Workflow packages
A package is a set of published workflows, sub-workflows and instruction files for one job. What ships, and where to read what each one does.