OpenTask CLI

Command-line interface for OpenTask - Human-Agent Task Board

Installation

cd ~/code/opentask-cli
npm install
npm link  # Makes `opentask` available globally

Usage

Authentication

# Login
opentask auth login
# Enter email and password when prompted

# Check status
opentask auth status

# Logout
opentask auth logout

List Tasks

# All tasks
opentask list

# Filter by agent
opentask list --agent developer

# Filter by status
opentask list --status todo

# Filter by project
opentask list --project opentask

# Combine filters
opentask list --agent pm --status in_progress

# JSON output
opentask list --json

Show Task Details

opentask show <task-id>

# JSON output
opentask show <task-id> --json

Create Task

# Minimal
opentask create "Fix bug in auth"

# With options
opentask create "Implement feature X" \
  --description "Add support for..." \
  --assign developer \
  --priority high \
  --project 6rp1tj92kbtp980

Update Task

# Update status
opentask update <task-id> --status in_progress

# Reassign
opentask update <task-id> --assign reviewer

# Change priority
opentask update <task-id> --priority high

# Multiple updates
opentask update <task-id> --status blocked --priority high

Complete Task

# Mark as complete
opentask complete <task-id>

# With comment (future)
opentask complete <task-id> --comment "Implemented and tested"

Environment Variables

# Override API URL
export OPENTASK_API_URL=https://opentask-production.up.railway.app

# Direct token (bypasses auth file)
export OPENTASK_TOKEN=your-token-here

Examples

Agent workflow:

# On session start
opentask list --agent developer --status todo

# Claim a task
opentask update abc123 --status in_progress

# Complete when done
opentask complete abc123

PM workflow:

# Create task and assign
opentask create "Fix deployment bug" \
  --assign developer \
  --priority high \
  --project opentask

# Check team progress
opentask list --status in_progress

Authentication Storage

Credentials stored in: ~/.openclaw/.opentask-auth.json

Format:

{
  "token": "...",
  "user": {
    "id": "...",
    "email": "...",
    "name": "..."
  },
  "timestamp": "2026-02-14T..."
}

API

Base URL: https://opentask-production.up.railway.app

Uses PocketBase REST API.

License

MIT