@telodesk/cli

Command-line interface for TeloDesk — manage projects, tasks, and time tracking from your terminal.

Install

npm i -g @telodesk/cli

Quick Start

# 1. Login with your API key (create one in Settings > API Keys)
telodesk login <your-api-key>

# 2. Link to a project
telodesk link <project-short-id>

# 3. Start working
telodesk tasks
telodesk start TSK-xxxxxx
telodesk done --yes

Commands

| Command | Description | |---------|-------------| | telodesk login <key> | Authenticate with your API key | | telodesk whoami | Show current user info | | telodesk link <id> | Link current directory to a project | | telodesk unlink | Remove project link | | telodesk status | Show project overview | | telodesk tasks | List tasks (filterable by status) | | telodesk task <id> | Show task details | | telodesk add <title> | Create a new task | | telodesk start <id> | Start working on a task (opens a session) | | telodesk review <id> | Move task to review | | telodesk done [id] | Complete a task (closes session) | | telodesk log <message> | Add a log entry to current task | | telodesk phases | List project phases | | telodesk phase-add <name> | Create a new phase | | telodesk phase-done <id> | Mark phase as completed |

Configuration

| Priority | Source | Example | |----------|--------|---------| | 1 | --url flag | telodesk login --url http://localhost:3000 <key> | | 2 | TELODESK_API_URL env | export TELODESK_API_URL=http://localhost:3000 | | 3 | Default | https://telodesk.com |

Credentials are stored in ~/.config/telodesk/credentials (mode 600).

Features

• Time tracking — automatic session management with start/done
• Git context — captures branch, commits, and diff stats automatically
• Short IDs — human-readable IDs (PRJ-xxx, TSK-xxx, PHS-xxx)
• Rate limited — 60 requests/min per API key

License

MIT