Installation

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

Prerequisites

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:

1. 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

2. Create the directory structure:

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

3. Copy the agent and workflow definitions from the GitHub repository.

4. 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.