Skip to main content

CLI Reference

Complete reference for AnyTask CLI commands and usage.

Overview

AnyTask CLI provides a comprehensive set of commands for managing tasks, workspaces, and projects from the command line. This section covers all available commands, their options, and usage examples.

Quick Navigation

Command Categories

Initialization & Authentication

Initialize workspace and configure authentication:
anyt login                                    # Login with API key
anyt init                                     # Initialize workspace (interactive)
anyt init --workspace-id <id> --project-id <id>  # Non-interactive init
anyt health check                             # Check backend health
See Quick Start for details.

Task Management

Core task operations:
# Create and update tasks
anyt task add <title>             # Create new task
anyt task edit <id>               # Update task
anyt task done <id>               # Mark as done
anyt task rm <id>                 # Delete task

# View tasks
anyt task list                    # List all tasks
anyt task show <id>               # Get task details
anyt task suggest                 # Get task suggestions

# Active task tracking
anyt task pick <id>               # Pick task to work on
anyt active                       # Show current task

# Dependencies
anyt task dep add <task> --on <other>     # Add dependency
anyt task dep rm <task> --on <other>      # Remove dependency
anyt task dep list <task>                 # List dependencies
See Usage Guide for details.

Local Task Sync

Pull and push tasks between server and local filesystem:
anyt pull <id>               # Pull task to local
anyt push <id>               # Push local changes
anyt push --done             # Push and mark as done

Comments

Manage task comments:
anyt comment add <task> -m <message>  # Add comment
anyt comment list <task>              # List comments

Coding Agent Integration

Manage coding agent integrations:
anyt agent install           # Install agent commands (interactive)
anyt agent install claude    # Install for Claude Code
anyt agent list              # List agent status
anyt agent uninstall claude  # Remove agent commands
See Coding Agents for details.

Reporting

Generate reports and summaries:
anyt summary                      # Workspace summary
anyt summary --period weekly      # Weekly summary
anyt summary --json               # JSON format

Worker System

Automated task execution:
anyt worker start                       # Start worker (interactive)
anyt worker start --workflow local_dev  # Start specific workflow
anyt worker list-workflows              # List available workflows
anyt worker check                       # Check workflow requirements
anyt worker validate-workflow <file>    # Validate workflow file
See Worker System for details.

Workflow Artifacts & Attempts

Track workflow execution:
anyt task attempt list <task-id>        # List attempts
anyt task attempt show <attempt-id>     # Show attempt details
anyt task artifact download <id>        # Download artifact

CLI Management

Manage CLI installation and configuration:
anyt self check              # Check for updates
anyt self update             # Update to latest version
anyt self info               # Show installation info
anyt config status           # Show config status
anyt config set-api-key      # Store API key

Output Formats

Most commands support JSON output for scripting:
# Default: Rich table format (for humans)
anyt task list

# JSON format (for scripting)
anyt task list --json

Global Options

Available for all commands:
--help              # Show help message
--version           # Show CLI version
--json              # Output in JSON format

Environment Variables

Override configuration with environment variables:
  • ANYT_API_KEY - Agent API key (required for authentication)
  • ANTHROPIC_API_KEY - Anthropic API key (for Claude Code actions)

Exit Codes

The CLI uses standard exit codes:
CodeDescription
0Success
1General error
2Invalid command or arguments
3Authentication error
4Not found (task, workspace, etc.)
5Validation error
Use these for scripting:
if anyt task show DEV-123; then
  echo "Task exists"
else
  echo "Task not found"
fi

Next Steps