Installation

Assemble can be installed in three ways. All methods produce the same result: platform-native configuration files in your project.

Prerequisites

Requirement	Version
Node.js	>= 18.0
npm / pnpm / yarn	Any recent version
AI coding tool	Cursor, Claude Code, VS Code + Copilot, Windsurf, etc.

Method 1 — npx (recommended)

The interactive wizard is the easiest way to get started:

npx cohesiumai-assemble

The wizard asks you:

Which platforms do you target? (multi-select from 21 options)
Team profile: startup (lean, fast), enterprise (governance, audit), or agency (multi-client)
Governance level: none, standard, or strict
Language: the language your team communicates in
YOLO mode: autonomous execution without intermediate validation

Method 2 — Bash one-liner

For CI/CD pipelines or scripted setups:

curl -fsSL https://assemble.cohesium.ai/install.sh | bash

This downloads and runs the wizard non-interactively with sensible defaults. You can pass flags:

curl -fsSL https://assemble.cohesium.ai/install.sh | bash -s -- \
  --platforms cursor,claude-code \
  --profile startup \
  --governance none \
  --lang en \
  --yolo true

Method 3 — Manual setup

If you prefer full control:

Create .assemble.yaml at your project root:

version: "1.0"
platforms:
  - cursor
  - claude-code
profile: startup
governance: none
langue_equipe: en
yolo: true
memory: true
metrics: true

Create the directory structure:

mkdir -p .assemble/agents .assemble/workflows .assemble/rules assemble-output

Copy the agent and workflow definitions from the GitHub repository.
Run the generator to produce platform-native files:

npx cohesiumai-assemble generate

Verifying the installation

Run the doctor command to verify everything is correctly set up:

npx cohesiumai-assemble doctor

This checks:

Configuration file exists and is valid
All referenced agents have definitions
All workflows reference existing agents
Platform-native files are generated and up to date
Output directory exists

Expected output:

✓ .assemble.yaml found and valid
✓ 34/34 agents have definitions
✓ 15/15 workflows valid
✓ 2/2 platform files generated
✓ assemble-output/ directory exists

All checks passed. Assemble is ready.

Updating

To update Assemble to the latest version:

npx cohesiumai-assemble --update

This preserves your configuration and regenerates platform-native files with the latest agent definitions and workflows.

Uninstalling

To remove Assemble from your project:

npx cohesiumai-assemble eject

This removes all generated files but leaves your assemble-output/ deliverables intact.