AnyTask CLI

AI-native task management from the terminal. Manage tasks, projects, and workspaces with powerful filtering, local caching, and git integration.

Installation

# Install globally via npm
npm install -g @bsheng/anyt

# Or via pnpm
pnpm add -g @bsheng/anyt

Quick Start

# 1. Login with your API key
anyt login

# 2. Initialize workspace in your project directory
anyt init

# 3. View your task board
anyt board

# 4. Start working on a task
anyt task start DEV-123

Configuration

Authentication

# Interactive login (recommended)
anyt login

# Or set API key directly
anyt config set-key sk_your_api_key_here

# Set custom API URL (optional, for self-hosted)
anyt config set-url https://api.anytask.app

Workspace Setup

# Interactive workspace initialization
anyt init

# Or configure manually
anyt config set-workspace <workspace-id>
anyt config set-project <project-id>

# View current configuration
anyt config show
anyt config status   # Detailed status

Configuration is stored at platform-specific locations:

• macOS: ~/Library/Preferences/anyt/config.json
• Linux: ~/.config/anyt/config.json
• Windows: %APPDATA%\anyt\config.json

Task Management

Listing Tasks

# List all tasks (default: pretty format)
anyt task list

# Filter by status
anyt task list --status todo
anyt task list --status active
anyt task list --status done

# Filter by project
anyt task list --project <project-id>

# Filter by priority
anyt task list --priority 2           # Exact priority
anyt task list --priority-gte 1       # High priority and above

# Filter by owner
anyt task list --owner me             # My tasks
anyt task list --owner <user-id>

# Output formats
anyt task list --format table
anyt task list --format json
anyt task list --json                 # Standardized JSON schema

Creating Tasks

# Simple task
anyt task add "Implement user authentication"

# Task with options
anyt task add "Fix login bug" \
  --status todo \
  --priority 2 \
  --description "Users can't log in with Google OAuth" \
  --project <project-id>

# Task with implementation plan
anyt task add "Build API endpoint" --plan-file ./plan.md

# Subtask (with parent)
anyt task add "Write unit tests" --parent DEV-123

Viewing & Updating Tasks

# Show task details
anyt task show DEV-123

# Update task properties
anyt task edit DEV-123 --status active
anyt task edit DEV-123 --title "New title" --priority 1

# Mark task as done
anyt task done DEV-123
anyt task done              # Uses active task

# Delete task (soft delete)
anyt task rm DEV-123

Task Workflow

The CLI supports a pick → work → done workflow:

# Pick a task to work on (sets local active task)
anyt task pick DEV-123

# View current active task
anyt active

# Start working (pick + set active + create git branch)
anyt task start DEV-123
anyt task start DEV-123 --branch feature/auth --base develop

# Clear active selection
anyt task unpick

# Get task suggestions based on priority and dependencies
anyt task suggest
anyt task suggest --limit 5 --status todo

Local Task Sync

Download tasks for offline work and sync changes:

# Download a task to local .anyt/tasks/ directory
anyt task pull DEV-123
anyt task pull DEV-123 --pick    # Pull and set as active

# Download all your assigned tasks
anyt task pull --mine
anyt task pull --mine --status active

# Push local changes to server
anyt task push DEV-123
anyt task push                   # Push all modified tasks
anyt task push DEV-123 --done    # Push and mark as done

# Open task folder
anyt task open DEV-123
anyt task open --code            # Open in VSCode
anyt task open --finder          # Open in Finder/Explorer

Task Dependencies

# Add dependencies
anyt task dep add DEV-123 --on DEV-100,DEV-101

# List dependencies
anyt task dep list DEV-123

# Remove dependencies
anyt task dep rm DEV-123 --on DEV-100

Implementation Plans

# View task's implementation plan
anyt task plan show DEV-123

# Add/update plan via edit
anyt task edit DEV-123 --plan "Step 1: Setup\nStep 2: Implement"
anyt task edit DEV-123 --plan-file ./plan.md

Pull Requests

# Register a PR for a task
anyt task pr register DEV-123 --pr-url https://github.com/org/repo/pull/42

# List PRs for a task
anyt task pr list DEV-123

# Show PR details
anyt task pr show DEV-123

Comments

# Add comment to a task
anyt comment add DEV-123 -m "Started implementation"
anyt comment add -m "Update"    # Uses active task

# List comments
anyt comment list DEV-123

Board View

Get a summary of tasks across your workspace:

# Show task board
anyt board

# Filter options
anyt board --project <project-id>
anyt board --phase "Sprint 1"
anyt board --period weekly

# Output formats
anyt board --format markdown
anyt board --json

Project Management

# List projects
anyt project list
anyt project list --status active

# Show project details
anyt project show <project-id>

# Create project
anyt project create "Q1 Planning" \
  --description "Strategic planning for Q1 2025" \
  --color "#FF5733" \
  --start-date 2025-01-01 \
  --target-date 2025-03-31

Workspace Management

# List accessible workspaces
anyt workspace list

# Show workspace details
anyt workspace show
anyt workspace show <workspace-id>

Agent Integration

Integrate with coding agents like Claude Code:

# List available agents
anyt agent list

# Install an agent
anyt agent install <agent-name>

# Uninstall an agent
anyt agent uninstall <agent-name>

Worker Automation

Run automated workflows:

# Start a worker instance
anyt worker start

# Run a specific workflow
anyt worker run <workflow-name>

# Check worker status
anyt worker check

# List available workflows
anyt worker list-workflows

Health Check

# Check API server health
anyt health

CLI Self-Management

# Show CLI info
anyt self info

# Check for updates
anyt self check

# Update to latest version
anyt self update

Output Formats

Most commands support multiple output formats:

• pretty (default): Human-readable colored output
• table: Formatted table view
• json: Machine-readable JSON with standardized schema

anyt task list --format pretty
anyt task list --format table
anyt task list --json          # Standardized JSON output

JSON Schema

All JSON responses follow a consistent schema:

// Success (single item)
{
  "success": true,
  "data": { ... }
}

// Success (list)
{
  "success": true,
  "items": [...],
  "count": 10,
  "total": 100
}

// Error
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Error message"
  }
}

Command Aliases

Many commands have shorter aliases:

| Command | Alias | | ---------------- | --------------- | | anyt task | t | | anyt task list | ls | | anyt task show | get | | anyt task add | create, new | | anyt task edit | update | | anyt task rm | delete | | anyt task done | complete | | anyt project | p | | anyt workspace | ws | | anyt comment | c | | anyt board | summary | | anyt worker | w |

CI/CD Integration

# Create task from CI pipeline
TASK_OUTPUT=$(anyt task add "Deploy to production" --status active --json)
TASK_ID=$(echo $TASK_OUTPUT | jq -r '.data.id')

# Update on completion
anyt task done $TASK_ID --note "Deployed successfully"

Troubleshooting

"API key not configured"

anyt login
# or
anyt config set-key <your-api-key>

"Workspace ID not configured"

anyt init
# or
anyt config set-workspace <workspace-id>

"Authentication failed"

Your API key may be invalid or expired. Generate a new one:

anyt config clear-api-key
anyt login

Connection errors

Check your configuration:

anyt config status
anyt health

Support

For issues or questions, contact the AnyTask team.

License

Private - AnyTask Internal Tool