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-dev/cli

Quick Start

The fastest way to get started — one command handles signup, verification, and your first task:

npx @delega-dev/cli init

The interactive wizard walks you through signing up with your email, verifying, and getting your API key — ending with a working key, a demo task, and ready-to-paste MCP config.

Already have an account?

# 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 

Commands

Getting Started

delega init           # Interactive setup wizard (signup + MCP config)

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                      # Show task details (incl. context + comments)
delega tasks complete                  # Mark task as completed
delega tasks delete                    # Delete a task
delega tasks assign     # Assign a task (no delegation chain)
delega tasks delegate   --content "subtask description"
delega tasks chain                     # Show the parent/child delegation chain
delega tasks set-context  --context '{"k":"v"}'
delega tasks set-context  --kv k=v     # Merge keys into the task context blob
delega tasks dedup --content "proposed content"
delega tasks claim                         # Atomically claim the next available task
delega tasks claim --project  --labels "backend,bug" --lease 600
delega tasks heartbeat                 # Extend the lease on a claimed task
delega tasks heartbeat  --lease 600    # Extend with a custom lease (30-3600s)
delega tasks release                   # Release a claimed task back to the queue
delega tasks state  waiting_input      # Report session state on a claimed task

Connect GitHub

delega github connect                       # Open GitHub's install page; auto-links selected repos
delega github connect --no-open             # Print the install URL instead of opening a browser

Links repositories via the hosted GitHub App so commits/PRs that mention a task (delega:#, or Closes-Delega: # to complete on merge) link back to it. The repos you select are registered automatically — no installation IDs to copy.

Repo Sync

delega sync init --repo owner/name          # Create .delega/config.json + tasks.jsonl
delega sync pull                            # Pull hosted tasks into .delega/tasks.jsonl
delega sync status                          # Show local vs hosted drift
delega sync push                            # Push local JSONL edits with CAS conflict checks
delega sync push --no-auto-link             # Disable branch/HEAD auto-linking

Recurring Tasks

delega recurring list
delega recurring create "Replace furnace filter" --rule monthly --anchor-day 1 --timezone America/Chicago
delega recurring create "Schedule review" --rule weekly --anchor-weekday 1 --interval 2
delega recurring update  --inactive
delega recurring update  --active --next-due-at 2026-07-01T14:00:00Z
delega recurring delete  --yes

Recurring rules support daily, weekly, monthly, and yearly. Use --no-skip-if-open on create, or --allow-overlap on update, when a template should spawn even if an earlier instance is still open.

Agents

delega agents list                              # List agents
delega agents create                      # Create an agent
delega agents create  --display-name "Friendly Name"
delega agents rotate                        # Rotate an agent's API key (admin key required)
delega agents role  coordinator             # Set role: worker, coordinator, admin (admin key required)
delega agents delete                        # Delete an agent (admin key required)

Roles: worker (own-task scope, default), coordinator (sees + can comment on all account tasks), admin (full account management).

Diagnostics & Account

delega status         # Connection check, agent info, task counts
delega stats          # Show usage statistics
delega usage          # Plan quota and rate-limit info
delega reset          # Clear stored credentials and config

Global Options

--json                # Output raw JSON for any command
--api-url        # Override API URL
--version             # Show version
--help                # Show help

Configuration

Non-secret CLI settings are stored in ~/.delega/config.json:

{
  "api_url": "https://api.delega.dev"
}

delega login stores API keys in the OS credential store when one is available:

• macOS: Keychain
• Linux: libsecret keyring via secret-tool
• Windows: DPAPI-protected user storage

Existing api_key entries in ~/.delega/config.json are still read for backward compatibility until the next successful delega login.

Environment Variables

| Variable | Description | |---|---| | DELEGA_API_KEY | API key (overrides secure storage and config) | | DELEGA_AGENT_KEY | Fallback API key for MCP/CLI shared environments | | DELEGA_API_URL | API base URL (overrides config file) |

Environment variables take precedence over the config file.

Custom API Endpoints

The CLI defaults to the Delega API at https://api.delega.dev/v1. To target a custom endpoint (advanced), set DELEGA_API_URL. Bare localhost URLs automatically use the /api namespace; remote custom endpoints should include /api explicitly.

Security Notes

• delega login now hides API key input instead of echoing it back to the terminal.
• delega login stores API keys in the OS credential store instead of plaintext config when secure storage is available.
• ~/.delega/config.json is written with owner-only permissions (0600), and the config directory is locked to 0700.
• Remote API URLs must use https://; plain http:// is only accepted for localhost / 127.0.0.1.
• On servers that do not expose /agent/me, delega login and delega whoami fall back to generic authentication checks instead of printing hosted account metadata.

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: delega-dev
• Source: delega-dev/delega-cli
• License: MIT

Install and usage instructions live in the source repository linked above.