@taskdemonai/cli NPM

TaskDemon CLI

TaskDemon CLI is a powerful command-line interface for the TaskDemon platform, allowing developers to run AI agents locally that can handle software development tasks including triaging issues, planning solutions, implementing code changes, and creating technical documentation.

Features

🤖 Run specialized AI agents locally to handle different aspects of software development
📋 Triage issues, plan solutions, implement code changes, and create technical documentation
🔄 Integrate with your existing workflows and GitHub repositories
📊 Track agent progress and monitor task status
🔒 Secure authentication with your TaskDemon account

Prerequisites

The TaskDemon CLI requires Node.js v18 or later and one of the following AI coding assistants:

Installation

# Install from npm
npm install -g @taskdemonai/cli

# Or using pnpm
pnpm add -g @taskdemonai/cli

Setting Up an AI Coding Assistant

TaskDemon requires one of the following AI coding assistants to be installed on your system.

Setting up Claude Code (Recommended)

Sign up for an Anthropic account at claude.ai
Install Claude Code:
```
npm install -g @anthropic/claude-code
```
Log in to Claude:
```
claude login
```

For more detailed instructions, visit the Claude Code documentation.

Setting up OpenAI Codex

Install the Codex CLI:
```
npm install -g @openai/codex-cli
```
Authenticate with OpenAI:
```
codex auth
```

For more detailed instructions, visit the OpenAI Codex documentation.

Setting up Aider

Install Aider:
```
pip install aider-chat
```
Configure your OpenAI API key:
```
export OPENAI_API_KEY=your-api-key
```

For more detailed instructions, visit the Aider documentation.

Getting Started

Authentication

First, authenticate with your TaskDemon account:

taskdemon login

This will open a browser window where you can log in to your TaskDemon account and authorize the CLI.

Environment Variable Authentication

For containerized environments or CI/CD pipelines, you can authenticate using the TASK_DEMON_API_TOKEN environment variable:

export TASK_DEMON_API_TOKEN=your-api-token
taskdemon auth status

This allows you to use the CLI without needing to manually log in, which is especially useful in non-interactive environments.

When both the environment variable and config file are present, the environment variable takes precedence.

Initializing Agents

Before using TaskDemon, you need to initialize agents in your project:

# Navigate to your project directory
cd your-project

# Initialize a default engineer agent (uses Claude Code by default)
taskdemon agent:init

# Initialize an engineer agent that uses Codex
taskdemon agent:init --engineer --name codex-engineer --tool codex

# Initialize a documenter agent that uses Aider
taskdemon agent:init --document --name aider-documenter --tool aider

Agent Types

Engineer Agent: Handles triage, planning, and implementation workflows

taskdemon agent:init --engineer --name engineer

# With specific coding tool
taskdemon agent:init --engineer --name engineer --tool codex

Documenter Agent: Specializes in creating technical documentation

taskdemon agent:init --document --name documenter

# With specific coding tool
taskdemon agent:init --document --name documenter --tool claude

Running Agents

Start an agent to begin processing tasks:

# Start the default agent
taskdemon agent:start

# Start a specific agent by name
taskdemon agent:start --name engineer

# Start an agent with a specific coding tool
taskdemon agent:start --name engineer --tool codex

# Start all agents in the project
taskdemon agent:start --all

The --tool flag accepts "claude" (default), "codex", or "aider" as values.

Checking Agent Status

Check the status of your agents:

# Check status of all agents
taskdemon agent:status

# Check status of a specific agent
taskdemon agent:status --name engineer

Workflows

TaskDemon supports different workflow types for different stages of software development:

Triage Workflow

Analyzes issues and categorizes them based on priority, complexity, and requirements.

taskdemon triage --issue-url https://github.com/your-org/your-repo/issues/123

Plan Workflow

Creates a detailed implementation plan for a task, breaking it down into actionable steps.

taskdemon plan --task-id task_123456

Implement Workflow

Executes the implementation plan by making code changes in your repository.

taskdemon implement --task-id task_123456

Document Workflow

Generates technical documentation based on your codebase and specifications.

taskdemon document --title "API Reference" --requirements "Create documentation for the user API"

Configuration

TaskDemon CLI configurations are stored in two locations:

Global Configuration: ~/.taskdemon/config.yml
Project Configuration: .taskdemon/config.yml in your project directory

You can view and modify these files directly, or use the CLI commands to update configurations.

Advanced Usage

Working with Multiple Agents

TaskDemon allows running multiple specialized agents simultaneously:

# Initialize multiple agents
taskdemon agent:init --engineer --name code-writer
taskdemon agent:init --engineer --name code-reviewer
taskdemon agent:init --document --name documenter

# Start all agents
taskdemon agent:start --all

Customizing Agent Settings

Edit the .taskdemon/config.yml file to customize agent settings, including the preferred coding tool:

projectId: "your-project-id"
agents:
  - name: engineer
    type: 
      - triage
      - plan
      - implement
    settings:
      tool: "claude"  # Use Claude Code for this agent
      pollingInterval: 30
      maxConcurrent: 2
      autoStart: true
  - name: codex-engineer
    type: 
      - triage
      - plan
      - implement
    settings:
      tool: "codex"  # Use OpenAI Codex for this agent
      pollingInterval: 30
      maxConcurrent: 2
      autoStart: false
  - name: documenter
    type:
      - document
    settings:
      tool: "aider"  # Use Aider for this agent
      pollingInterval: 60
      maxConcurrent: 1
      autoStart: false