Skip to main content

​
AnyTask CLI - Command Reference

Complete command reference auto-generated from CLI introspection.

​
Command Overview

CommandDescription
anyt activeShow the currently active task
anyt agentManage coding agent integrations
anyt commentManage task comments
anyt configManage CLI configuration
anyt healthCheck backend server health
anyt initInitialize AnyTask in current directory
anyt loginLogin to AnyTask using API key
anyt pullPull tasks from server to local filesystem
anyt pushPush local task changes to server
anyt selfManage the CLI installation
anyt summaryGenerate workspace summary
anyt taskManage tasks
anyt workerAutomated task worker commands

​
anyt

AnyTask - AI-native task management from the command line 
anyt [OPTIONS] COMMAND [ARGS]...
Options:
  • --version, -v - Show version and exit

​
anyt active

Show the currently active task. 
anyt active [--json]
Options:
  • --json - Output in JSON format

​
anyt agent

Manage coding agent integrations (Claude Code, Cursor, Codex, Gemini, etc.)

​
anyt agent install

Install slash commands for a coding agent. 
anyt agent install [AGENT_TYPE] [--force] [--json]
Arguments:
  • AGENT_TYPE - Agent type to install (e.g., ‘claude’). Interactive if omitted.
Options:
  • --force, -f - Override existing commands without prompting
  • --json - Output in JSON format
Examples: 
anyt agent install           # Interactive selection
anyt agent install claude    # Install Claude Code commands
anyt agent install --force   # Override existing commands

​
anyt agent list

List available coding agents and their installation status. 
anyt agent list [--json]

​
anyt agent uninstall

Uninstall slash commands for a coding agent. 
anyt agent uninstall AGENT_TYPE [--force] [--json]

​
anyt comment

Manage task comments.

​
anyt comment add

Add a comment to a task. 
anyt comment add [IDENTIFIER] -m MESSAGE [--json]
Examples: 
# Add comment to active task
anyt comment add -m "Completed implementation"

# Add comment to specific task
anyt comment add DEV-123 -m "Found edge case"

​
anyt comment list

List all comments on a task. 
anyt comment list [IDENTIFIER] [--json]

​
anyt config

Manage CLI configuration.

​
anyt config status

Show current configuration status. 
anyt config status

​
anyt config set-api-key

Store API key in global config file (~/.anyt/auth.json). 
anyt config set-api-key [--key KEY]

​
anyt config get-api-key

Show currently configured API key (masked). 
anyt config get-api-key

​
anyt config clear-api-key

Remove API key from global config file. 
anyt config clear-api-key [--yes]

​
anyt health

Check backend server health.

​
anyt health check

Check if the AnyTask backend server is healthy. 
anyt health check

​
anyt init

Initialize AnyTask in the current directory. 
anyt init [OPTIONS]
Options:
  • --workspace-id, -w - Workspace ID to link to
  • --workspace-name, -n - Workspace name (optional)
  • --identifier, -i - Workspace identifier (e.g., DEV, PROJ)
  • --project-id, -p - Project ID to use
  • --dir, -d - Directory to initialize (default: current)
  • --agents - Comma-separated list of agents to install
  • --dev - Use development API
  • --non-interactive, -y - Non-interactive mode
Examples: 
# Interactive mode (default)
anyt init

# With specific agents
anyt init --agents claude,cursor

# Non-interactive with auto-selection
anyt init -y

# CI/CD usage
anyt init --non-interactive --workspace-id 101 --project-id 5

​
anyt login

Login to AnyTask using API key. 
anyt login [--force] [--json]
Options:
  • --force, -f - Overwrite existing global config with environment variable
  • --json - Output as JSON

​
anyt pull

Pull tasks from server to local filesystem. 
anyt pull [IDENTIFIER] [OPTIONS]
Options:
  • --status - Filter by status (comma-separated)
  • --pick - Set the pulled task as active
  • --json - Output in JSON format
Examples: 
# Pull a single task
anyt pull DEV-01

# Pull and set as active task
anyt pull DEV-01 --pick

​
anyt push

Push local task changes to server. 
anyt push [IDENTIFIER] [OPTIONS]
Options:
  • --status - Override local status
  • --done - Push and mark task as done
  • --dry-run - Show what would be pushed without pushing
  • --json - Output in JSON format
Examples: 
# Push a single task
anyt push DEV-01

# Push and mark as done
anyt push DEV-01 --done

# Push all modified local tasks
anyt push

​
anyt self

Manage the CLI installation.

​
anyt self check

Check if a newer version is available. 
anyt self check [--json]

​
anyt self info

Show installation details. 
anyt self info [--json]

​
anyt self update

Update to the latest version. 
anyt self update [--force] [--json]

​
anyt summary

Generate workspace summary with done, active, blocked, and next priorities. 
anyt summary [OPTIONS]
Options:
  • --period - Summary period: today, weekly, monthly
  • --phase - Filter by phase/milestone
  • --project - Filter by project ID
  • --all - Show tasks from all projects
  • --format - Output format: text, markdown, json
  • --json - Output in JSON format

​
anyt task

Manage tasks.

​
anyt task add

Create a new task. 
anyt task add TITLE [OPTIONS]
Options:
  • -d, --description - Task description
  • --phase - Phase/milestone identifier
  • -p, --priority - Priority (-2 to 2, default: 0)
  • --labels - Comma-separated labels
  • --status - Task status (default: backlog)
  • --owner - Assign to user or agent ID
  • --estimate - Time estimate in hours
  • --project - Project ID
  • --plan - Implementation plan content
  • --plan-file - Read plan from file
  • --auto-approve-plan - Auto-approve the plan
  • --json - Output in JSON format

​
anyt task list

List tasks with filtering. 
anyt task list [OPTIONS]
Options:
  • --status - Filter by status (comma-separated)
  • --phase - Filter by phase/milestone
  • --assignee, -a - Filter by assignee
  • --labels - Filter by labels (comma-separated)
  • --project - Filter by project ID
  • --all - Show tasks from all projects
  • --sort - Sort field
  • --order - Sort order (asc/desc)
  • --limit - Max number of tasks
  • --json - Output in JSON format

​
anyt task show

Show detailed information about a task. 
anyt task show [IDENTIFIER] [OPTIONS]
Options:
  • --workspace, -w - Workspace identifier
  • --show-metadata - Display workflow metadata
  • --json - Output in JSON format

​
anyt task edit

Edit a task’s fields. 
anyt task edit [IDENTIFIER] [OPTIONS]
Options:
  • --title - New title
  • -d, --description - New description
  • --status - New status
  • -p, --priority - New priority (-2 to 2)
  • --labels - Comma-separated labels
  • --owner - New owner ID
  • --estimate - New time estimate
  • --dry-run - Preview changes
  • --json - Output in JSON format

​
anyt task done

Mark one or more tasks as done. 
anyt task done [IDENTIFIERS...] [OPTIONS]
Options:
  • --note, -n - Add a completion note
  • --json - Output in JSON format

​
anyt task pick

Pick a task to work on (sets as active task). 
anyt task pick [IDENTIFIER] [OPTIONS]
Options:
  • --status - Filter by status (comma-separated)
  • --project - Filter by project ID
  • --no-pull - Skip pulling task locally
  • --json - Output in JSON format

​
anyt task suggest

Suggest tasks to work on next based on priority and dependencies. 
anyt task suggest [OPTIONS]
Options:
  • --limit - Number of suggestions
  • --status - Filter by status
  • --include-assigned - Include assigned tasks
  • --json - Output in JSON format

​
anyt task rm

Delete one or more tasks (soft delete). 
anyt task rm [IDENTIFIERS...] [OPTIONS]
Options:
  • --force, -f - Skip confirmation
  • --json - Output in JSON format

​
anyt task dep

Manage task dependencies. 
# Add dependency
anyt task dep add [IDENTIFIER] --on DEV-123

# List dependencies
anyt task dep list [IDENTIFIER]

# Remove dependency
anyt task dep rm [IDENTIFIER] --on DEV-123

​
anyt task plan

Manage task implementation plans. 
# Show plan
anyt task plan show [IDENTIFIER]

# Submit plan
anyt task plan submit [IDENTIFIER] -p "Plan content"
anyt task plan submit [IDENTIFIER] -f plan.md

# Approve plan
anyt task plan approve [IDENTIFIER]

# Request changes
anyt task plan request-changes [IDENTIFIER] -f "Feedback"

​
anyt task pr

Manage task pull requests. 
# List PRs
anyt task pr list [IDENTIFIER]

# Show PR details
anyt task pr show [IDENTIFIER]

# Register PR
anyt task pr register [IDENTIFIER] --pr-number 123 --pr-url URL

​
anyt task open

Open a task folder in editor or file manager. 
anyt task open [IDENTIFIER] [OPTIONS]
Options:
  • --code - Open in VSCode
  • --finder - Open in file manager
  • --file, -f - Open specific file

​
anyt task artifact

Download workflow execution artifacts. 
anyt task artifact download ARTIFACT_ID [--output FILE] [--stdout]

​
anyt task attempt

View workflow execution attempts. 
anyt task attempt list TASK_ID
anyt task attempt show ATTEMPT_ID

​
anyt worker

Automated task worker commands.

​
anyt worker start

Start the task worker. 
anyt worker start [OPTIONS]
Options:
  • --workspace, -w - Workspace directory
  • --workflow - Workflow to run (remote_dev, local_dev, dry_run)
  • --workflows - Workflows directory
  • --poll-interval, -i - Polling interval in seconds
  • --max-backoff - Maximum backoff interval
  • --project-id, -p - Project ID to scope tasks
  • --skip-checks - Skip requirement validation
  • --force-check - Force fresh requirement checks
  • --clone-repos - Force clone project repos
  • --no-cleanup - Keep task workspaces after execution
  • --agents - Comma-separated list of agents
  • --skip-detection - Skip interactive agent detection
Examples: 
# Interactive workflow selection
anyt worker start

# Direct workflow selection
anyt worker start --workflow local_dev

# With explicit agents
anyt worker start --agents claude,codex

​
anyt worker list-workflows

List available workflows. 
anyt worker list-workflows [--show-requirements]

​
anyt worker check

Check workflow requirements. 
anyt worker check [WORKFLOW] [OPTIONS]
Options:
  • --workspace, -w - Workspace directory
  • --workflows - Custom workflows directory
  • --force, -f - Bypass cache
  • --json - Output as JSON

​
anyt worker validate-workflow

Validate a workflow definition. 
anyt worker validate-workflow WORKFLOW_FILE

​
anyt worker secret

Manage workflow secrets. 
# Set secret
anyt worker secret set NAME [--value VALUE]

# Get secret
anyt worker secret get NAME [--show]

# Delete secret
anyt worker secret delete NAME [--yes]

# Test interpolation
anyt worker secret test "API_KEY=\${{ secrets.API_KEY }}"

​
JSON Output

Many commands support the --json flag for machine-readable output. Success Response (Single Item): 
{
  "success": true,
  "data": { ... }
}
Success Response (List): 
{
  "success": true,
  "items": [...],
  "count": 10,
  "total": 100
}
Error Response: 
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Error message"
  }
}

​
Exit Codes

CodeDescription
0Success
1General error
2Invalid command or arguments
3Authentication error
4Not found (task, workspace, etc.)
5Validation error