Skedo CLI

Lightweight terminal client for Skedo.

Skedo CLI is a standalone TypeScript/Node.js app for working with Skedo tasks from the terminal. It talks to the Skedo API and stays thin: task logic, auth, permissions, and persistence live in the main Skedo app.

Install

npm install -g skedo-cli

Package name: skedo-cli. Executable on your PATH: skedo.

Check the installed CLI version:

skedo --version
# or: skedo -V
npm list -g skedo-cli

Configure

The CLI uses a built-in default API base URL for Skedo. Run skedo config show to see what is configured. To point at a different deployment (for example local development):

export SKEDO_BASE_URL=http://localhost:3000
# or
skedo config set-base-url http://localhost:3000

Create a personal access token in the Skedo web app, then:

skedo auth set-token <token>

What it’s for

Fast, terminal-first task work:

• add a task quickly
• list current tasks
• inspect a task
• move a task through workflow states
• mark work as done
• review task history

Commands

Task workflow

| Command | Purpose | |--------|---------| | skedo ls | List tasks | | skedo show <taskId> | Task detail (get alias) | | skedo add "<title>" | Create task (--priority, --category) | | skedo start <taskId> | Set status inprogress | | skedo stop <taskId> | Set status todo | | skedo review <taskId> | Set status review | | skedo done <taskId> | Set status done | | skedo history <taskId> | Per-task changelog | | skedo delete <taskId> | Delete task (rm alias) |

<taskId> can be a UUID or a public ref (e.g. SK-42).

JSON output

skedo --json ls
skedo --json show <taskId>
# …works with other commands too

Auth and config

skedo auth set-token <token>
skedo auth status
skedo config set-base-url <url>
skedo config show

Architecture

This CLI

• command structure and flags
• local config (via conf) and token storage
• HTTP to Skedo
• terminal output and light validation

Main Skedo app

• API routes
• authentication and authorization
• task business logic
• database and activity/history semantics

Non-goals

• direct database access
• local task persistence as source of truth
• full offline mode
• interactive TUI
• replacing the Skedo web app
• duplicating backend business logic

Development

• TypeScript, Node.js 20+
• commander, native fetch, picocolors, zod, conf

npm install
npm run build
npm test
npm run dev -- --help