Documentation
Getting Started

Getting Started

Conduct is an AI agent orchestrator that helps you manage specifications and coordinate multiple AI coding tools. This guide will help you get started in minutes.

Installation

Choose your preferred installation method:

via npm (Recommended) 

npm install -g conduct-cli

via install script 

curl -fsSL https://git.conduct.run/install.sh | bash

via npx (No Installation) 

npx conduct-cli init

From Source 

git clone https://github.com/conduct/conduct
cd conduct
pnpm install
pnpm build
cd cli && npm link

Initialize Your Project

Run the initialization command in your project directory:

conduct init

This interactive command will:

  1. Select AI Agents: Choose which AI coding tools you use (Cursor, Claude, Warp, etc.)
  2. Configure Issue Trackers: Optionally integrate with GitHub, Jira, Linear, GitLab, or Azure DevOps
  3. Set Base Paths: Configure URLs for your issue trackers

What Gets Created

After initialization, Conduct creates:

your-project/
├── conduct/
│   ├── spec.v0.md           # Root specification
│   ├── AGENTS.md            # AI agent instructions
│   ├── track.json           # Version tracking
│   ├── features/            # Feature specifications
│   └── changes/             # Root-level changes
├── .cursor/commands/        # Cursor commands (if selected)
├── .claude/commands/        # Claude commands (if selected)
├── .warp/commands/          # Warp commands (if selected)
├── CLAUDE.md                # Claude instructions (if selected)
└── WARP.md                  # Warp instructions (if selected)

Using AI Agent Commands

Once initialized, your AI agents will have access to custom commands:

Create a Feature

In your AI agent (e.g., Cursor, Claude, Warp), use:

/feature Create user authentication

This creates a new feature specification in conduct/features/user-authentication/

Create a Change

To propose a change to an existing feature:

/change Fix login validation bug

This creates a change specification and automatically versions the parent feature spec.

View Your Specifications

List all features and changes:

conduct list

Example output:

conduct/
├── spec.v0.md
├── features/
│   ├── user-authentication/
│   │   ├── spec.v1.md
│   │   └── changes/
│   │       └── fix-validation.spec.md
│   └── dashboard/
│       └── spec.v0.md
└── changes/
    └── update-dependencies.spec.md

Upgrade Instructions

Keep your AI agent instructions up to date:

conduct upgrade

This updates all agent command files and instruction documents to the latest version.

Next Steps

CLI Reference