Command Reference
All commands are invoked as cortask <command>. Global flags --version and --help are always available.
serve
Start the gateway server (REST API + WebSocket + static UI).
cortask serve [options]
| Flag | Default | Description |
|---|---|---|
-p, --port <port> | 3777 | Port to listen on |
--host <host> | 127.0.0.1 | Host to bind to |
chat
Open an interactive chat REPL. If the workspace path has not been registered yet, it is created automatically.
cortask chat [options]
| Flag | Default | Description |
|---|---|---|
-w, --workspace <path> | . (current directory) | Workspace directory path |
Inside the REPL, type /help for slash commands and /quit to exit.
run
Execute a one-shot prompt and print the result to stdout.
cortask run <prompt> [options]
| Flag | Default | Description |
|---|---|---|
-w, --workspace <path> | . | Workspace directory path |
setup
Initialize the data directory, default configuration, and skills folder.
cortask setup [options]
| Flag | Description |
|---|---|
--force | Overwrite existing configuration |
Default config values: Anthropic provider, port 3777, 25 max turns, temperature 0.7.
status
Show system status: configuration paths, gateway online/offline state, default provider, registered workspaces, and installed skill count.
cortask status
No flags. Exits with code 1 if no configuration file is found.
dashboard
Open the web UI in your default browser.
cortask dashboard [options]
| Flag | Description |
|---|---|
--no-open | Print the URL without opening the browser |
Warns if the gateway appears to be offline.
config
View and update configuration values.
config show
Display the full configuration (agent, server, spending, memory, skills sections).
cortask config show
config get
Read a single configuration value.
cortask config get <key>
The key uses dot notation, e.g. agent.maxTurns, server.port, spending.maxCostUsd.
config set
Write a configuration value. Values are auto-parsed to the correct type (boolean, integer, float, or string).
cortask config set <key> <value>
Valid sections: agent, server, spending, memory, skills.
cortask config set agent.maxTurns 50
cortask config set spending.enabled true
cortask config set server.port 4000
providers
Manage LLM providers.
providers list
List all available providers, showing which have API keys configured and which is the default.
cortask providers list
providers default
Set the default provider and optionally pin a model.
cortask providers default <provider> [model]
cortask providers default openai gpt-4o
cortask providers default anthropic
providers test
Verify provider credentials by sending a simple API call.
cortask providers test <provider>
sessions
Manage chat sessions stored per workspace.
sessions list
cortask sessions list -w <workspace-id>
| Flag | Description |
|---|---|
-w, --workspace <id> | Required. Workspace ID |
sessions show
Display the messages in a session.
cortask sessions show <id> -w <workspace-id> [options]
| Flag | Default | Description |
|---|---|---|
-w, --workspace <id> | -- | Required. Workspace ID |
-n, --limit <count> | 20 | Number of messages to display |
sessions delete
cortask sessions delete <id> -w <workspace-id>
models
Manage the model registry.
models list
List enabled models. Optionally filter by provider.
cortask models list [options]
| Flag | Description |
|---|---|
-p, --provider <provider> | Filter by provider ID |
models available
List hardcoded model definitions for a provider, including pricing.
cortask models available <provider>
models enable
Register a model in the local database with pricing information.
cortask models enable <provider> <model-id> <label> <input-price> <output-price>
Prices are per 1 million tokens in USD.
cortask models enable anthropic claude-sonnet-4-5-20250929 "Claude Sonnet" 3.00 15.00
models disable
Remove a model from the enabled list.
cortask models disable <provider> <model-id>
templates
Manage prompt templates.
templates list
List all templates, grouped by category.
cortask templates list
templates create
cortask templates create -n <name> -c <content> [--category <category>]
| Flag | Default | Description |
|---|---|---|
-n, --name <name> | -- | Required. Template name |
-c, --content <content> | -- | Required. Template content |
--category <category> | General | Category label |
templates update
cortask templates update <id> [-n <name>] [-c <content>] [--category <category>]
templates delete
cortask templates delete <id>
usage
View token usage and cost reports.
usage summary
Show aggregated usage for a period.
cortask usage summary [options]
| Flag | Default | Description |
|---|---|---|
-p, --period <period> | monthly | daily, weekly, or monthly |
Displays request count, input/output tokens, total tokens, and total cost.
usage history
Show a day-by-day usage table.
cortask usage history [options]
| Flag | Default | Description |
|---|---|---|
-d, --days <days> | 14 | Number of days to show |
channels
Manage messaging channel integrations. Requires the gateway to be running.
channels list
Show all channels and their running/authenticated status.
cortask channels list
channels start
Start a channel by ID.
cortask channels start <channel>
Channel IDs: telegram, discord, whatsapp.
channels stop
Stop a running channel.
cortask channels stop <channel>
workspaces
Manage workspace registrations.
workspaces list
cortask workspaces list
workspaces add
cortask workspaces add <name> <path>
workspaces remove
cortask workspaces remove <id>
credentials
Manage encrypted credentials (API keys, tokens).
credentials list
cortask credentials list
credentials set
cortask credentials set <key> <value>
cortask credentials set provider.anthropic.apiKey sk-ant-...
credentials remove
cortask credentials remove <key>
skills
Manage the skill plugin system.
skills list
cortask skills list
skills install
Install a skill from a Git repository.
cortask skills install <git-url>
skills create
Create a new custom skill.
cortask skills create <name> -c <content>
skills update
cortask skills update <name> -c <content>
skills show
Print the SKILL.md content of a skill.
cortask skills show <name>
skills remove
cortask skills remove <name>
cron
Manage scheduled agent jobs.
cron list
cortask cron list
cron add
cortask cron add -n <name> -s <cron-expression> -p <prompt> [-w <workspace-id>]
cron update
cortask cron update <id> [-n <name>] [-s <cron>] [-p <prompt>] [--enable] [--disable]
cron run
Execute a cron job immediately.
cortask cron run <id>
cron remove
cortask cron remove <id>
update
Check for new versions on the npm registry.
cortask update [options]
| Flag | Description |
|---|---|
--check | Only check, do not print install instructions |