@taskdemonai/cli

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:

• Claude Code (recommended)
• OpenAI Codex
• Aider

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.

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

License

TaskDemon CLI is licensed under the MIT License.

Support

For help or issues, please:

• Visit our documentation
• Open an issue on our GitHub repository
• Contact support at [e-mail]