Skip to main content

AnyTask CLI Usage Guide

Common workflows and usage patterns for the AnyTask CLI.

Quick Start

1. Install CLI

curl -fsSL https://anyt.dev/install.sh | sh

2. Authenticate

anyt login

3. Initialize Workspace

cd /path/to/your/project
anyt init

4. Verify Connection

anyt health check

Task Management

Create Tasks

# Basic task
anyt task add "Implement OAuth" --status todo

# With priority and labels
anyt task add "Fix login bug" --priority 2 --labels bug,auth

# With description
anyt task add "Update docs" -d "Add API documentation" --estimate 3

List Tasks

# All tasks
anyt task list

# Filter by status
anyt task list --status todo,in_progress

# Filter by labels
anyt task list --labels bug --limit 10

Show Task Details

anyt task show DEV-42
anyt task show  # Uses active task

Edit Tasks

anyt task edit DEV-42 --status in_progress
anyt task edit DEV-42 --priority 2 --labels bug,urgent

Mark as Done

anyt task done DEV-42
anyt task done DEV-42 --note "All tests passing"
anyt task done  # Marks active task as done

Delete Tasks

anyt task rm DEV-42
anyt task rm DEV-42 --force  # Skip confirmation

Active Task Workflow

Pick a task to make it the default for subsequent commands:
# Pick a task
anyt task pick DEV-42

# View active task
anyt active

# All commands now default to DEV-42
anyt task show        # Shows DEV-42
anyt task edit --status in_progress
anyt comment add -m "Progress update"
anyt task done        # Marks DEV-42 as done

Comments

# 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"

# List comments
anyt comment list DEV-123

Dependencies

# Add dependency (DEV-43 depends on DEV-42)
anyt task dep add DEV-43 --on DEV-42

# List dependencies
anyt task dep list DEV-43

# Remove dependency
anyt task dep rm DEV-43 --on DEV-42

Sync Tasks Locally

# Pull task to local filesystem
anyt pull DEV-42

# Pull and set as active
anyt pull DEV-42 --pick

# Push local changes
anyt push DEV-42

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

Workspace Summary

anyt summary
anyt summary --period weekly
anyt summary --format markdown > summary.md

Worker System

Start the background worker for autonomous task execution:
# Interactive workflow selection
anyt worker start

# Specific workflow
anyt worker start --workflow local_dev

# List available workflows
anyt worker list-workflows

JSON Output

Most commands support --json for machine-readable output:
anyt task list --json
anyt task show DEV-42 --json

Environment Variables

  • ANYT_API_KEY: Agent API key (required)
  • ANTHROPIC_API_KEY: Anthropic API key (for Claude Code actions)

Troubleshooting

Not authenticated

anyt login

Not in a workspace directory

anyt init

Connection issues

anyt health check

Next Steps