delega-cli

     ____       __
    / __ \___  / /__  ____ _____ _
   / / / / _ \/ / _ \/ __ `/ __ `/
  / /_/ /  __/ /  __/ /_/ / /_/ /
 /_____/\___/_/\___/\__, /\__,_/
                   /____/
  Task infrastructure for AI agents

delega-cli

CLI for the Delega task API. Manage tasks, agents, and delegations from your terminal.

Installation

npm install -g delega-cli

Quick Start

# Authenticate with your API key
delega login

# Create a task
delega tasks create "Review pull request #42" --priority 1

# List your tasks
delega tasks list

# Complete a task
delega tasks complete <task-id>

Commands

Authentication

delega login          # Authenticate with your API key
delega whoami         # Show current authenticated agent

Tasks

delega tasks list                          # List tasks
delega tasks list --completed              # Include completed tasks
delega tasks list --limit 10               # Limit results
delega tasks create "content"              # Create a task
delega tasks create "content" --priority 1 # Create with priority (1-4)
delega tasks create "content" --labels "bug,urgent"
delega tasks create "content" --due "2026-03-15"
delega tasks show <id>                     # Show task details
delega tasks complete <id>                 # Mark task as completed
delega tasks delete <id>                   # Delete a task
delega tasks delegate <task-id> <agent-id> # Delegate to another agent
delega tasks delegate <task-id> <agent-id> --content "subtask description"

Agents

delega agents list                              # List agents
delega agents create <name>                     # Create an agent
delega agents create <name> --display-name "Friendly Name"
delega agents rotate <id>                       # Rotate an agent's API key

Stats

delega stats          # Show usage statistics

Global Options

--json                # Output raw JSON for any command
--api-url <url>       # Override API URL (for self-hosted instances)
--version             # Show version
--help                # Show help

Configuration

Config is stored in ~/.delega/config.json:

{
  "api_key": "dlg_...",
  "api_url": "https://api.delega.dev"
}

Environment Variables

Variable	Description
DELEGA_API_KEY	API key (overrides config file)
DELEGA_API_URL	API base URL (overrides config file)

Environment variables take precedence over the config file.

License

MIT