CLI Overview - Trilo Developer Documentation

The Trilo CLI (trilo) lets you interact with your workspace directly from the terminal. List tasks, send messages, create pages, trigger workflows — all without opening a browser.

What You Can Do

trilo tasks list --status in_progress --json
trilo messages send --content "Deploy complete" --project-id <id> --sender-id <id>
trilo workflows run --page-id <id>
trilo projects list --json | jq '.[].name'

Category	Commands
Tasks	`list`, `get`, `create`, `update`
Pages	`list`, `get`, `create`
Projects	`list`, `get`
Events	`list`, `create`
Members	`list`
Messages	`send`, `send-direct`, `list`
Workflows	`run`, `status`, `continue`

Quick Start

Install

The CLI runs via Bun. From the Trilo monorepo:

cd packages/cli && bun link

Authenticate

trilo login

This opens your browser to authorize the CLI. Your token is stored securely in ~/.config/trilo/.

Use it

trilo tasks list
trilo projects list --json

Authentication Methods

Browser Login (OAuth)

Run trilo login to authenticate via your browser. Tokens auto-refresh when expired.

Personal Access Token

Set TRILO_TOKEN env var for CI/CD and scripting. Create tokens in workspace settings.

Output Formats

The CLI auto-detects your context:

Interactive terminal — human-readable tables
Piped (trilo tasks list | jq) — auto-switches to JSON
--json flag — forces JSON in all contexts

This makes the CLI composable with standard Unix tools like jq, grep, and awk.

​What You Can Do

​Quick Start

​Authentication Methods