@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)
• 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 either Claude Code or Aider 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 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
taskdemon agent:init

# Or initialize a documenter agent
taskdemon agent:init --document --name documenter

Agent Types

• Engineer Agent: Handles triage, planning, and implementation workflows

taskdemon agent:init --engineer --name engineer

• Documenter Agent: Specializes in creating technical documentation

taskdemon agent:init --document --name documenter

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 all agents in the project
taskdemon agent:start --all

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:

projectId: "your-project-id"
agents:
  - name: engineer
    type: 
      - triage
      - plan
      - implement
    settings:
      pollingInterval: 30
      maxConcurrent: 2
      autoStart: true
  - name: documenter
    type:
      - document
    settings:
      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]