Conduct CLI

AI agent orchestrator with specification management tools.

Installation

From npm

npm install -g conduct-cli

From Source

# Install dependencies
pnpm install

# Build
pnpm build

# Link globally (optional)
npm link

Usage

Once installed, the conduct command is available globally.

Commands

conduct init

Initialize a conduct/ folder structure and configure AI agents.

conduct init

Interactively prompts you to:

• Select AI agents to configure (Cursor, Claude, Factory, OpenCode, GitHub Copilot, Warp)
• Choose issue trackers to integrate (GitHub, Jira, Linear, GitLab, Azure DevOps)
• Set base paths for each tracker

Creates:

• conduct/ directory
• conduct/spec.v0.md - Root specification file
• conduct/AGENTS.md - AI agent guidance document
• conduct/features/ - Feature specifications directory
• conduct/changes/ - Root-level changes directory
• conduct/track.json - Version and issue tracker configuration
• Agent-specific command files (e.g., .warp/commands/conduct/feature.md)
• Root-level instruction files (e.g., WARP.md, CLAUDE.md)

conduct list

List all features and changes in the hierarchy.

conduct list

Displays:

• Feature tree with version numbers
• Nested features and sub-features
• Changes under each feature
• Root-level changes

conduct upgrade

Upgrade Conduct instructions to the latest version in all configured AI agents.

conduct upgrade

Updates:

• conduct/AGENTS.md
• All agent command files (feature.md, change.md)
• Root-level instruction blocks in CLAUDE.md and WARP.md

Examples

# Initialize conduct with AI agents and issue trackers
conduct init

# View the feature/change hierarchy
conduct list

# Upgrade all agent instructions to latest version
conduct upgrade

Supported AI Agents

• Cursor - .cursor/commands/
• Claude - .claude/commands/conduct/ + CLAUDE.md
• Factory - .factory/commands/
• OpenCode - .opencode/command/
• GitHub Copilot - .github/prompts/
• Warp - .warp/commands/conduct/ + WARP.md

Supported Issue Trackers

• GitHub Issues
• Jira
• Linear
• GitLab Issues
• Azure DevOps

How It Works

AI Agent Integration

Conduct creates command files that AI agents can use to:

• Create feature specifications with proper structure
• Generate change specifications linked to features
• Reference issue tracker tickets in specs
• Follow project conventions automatically

Version Management

When changes are created:

1. Parent feature's spec file is automatically versioned
2. Example: spec.v0.md → spec.v1.md
3. Both versions preserved for audit trail
4. Version tracked in track.json

Development

# Build
pnpm build

# Watch mode
pnpm dev

# Type check
pnpm lint

Structure

cli/
├── src/
│   ├── index.ts           # Main CLI entry point
│   ├── templates.ts       # Spec and agent instruction templates
│   ├── commands/
│   │   ├── init.ts        # Initialize conduct structure and agents
│   │   ├── list.ts        # List features and changes
│   │   └── update.ts      # Upgrade agent instructions
│   └── utils/
│       └── track.ts       # Version and tracker management
├── dist/                  # Compiled JavaScript (generated)
├── package.json
└── tsconfig.json