# 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:

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](https://github.com/CohesiumAI/assemble/tree/main/.assemble).

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.