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 & Health

Initialize workspace and check backend connection: 
anyt init --workspace-id <id> --identifier <prefix>  # Initialize workspace
anyt health check                                     # Check backend health
See Initialization 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 board                        # View Kanban board

# 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
anyt graph <task>                         # Visualize dependencies
See Task Management for details.

​
Comments

Manage task comments: 
anyt comment add <task> -m <message>  # Add comment
anyt comment list <task>              # List comments
See Comments for details.

​
Visualization & Reporting

View tasks and generate reports: 
anyt board                        # Kanban board view
anyt graph <task>                 # Dependency graph
anyt timeline <task>              # Task timeline
anyt summary                      # Workspace summary
See Visualization for details.

​
Worker System

Automated task execution: 
anyt worker start --agent-id <id>        # Start worker
anyt worker list-workflows               # List workflows
anyt worker validate-workflow <file>     # Validate workflow
See Worker System for details.

​
Workflow Artifacts & Attempts

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

​
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)
  • ANYT_CONFIG_DIR - Config directory (default: ~/.config/anyt)
See Configuration for details.

​
Exit Codes

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

​
Next Steps