Skip to main content
Get the Trilo CLI running on your machine in under 2 minutes.

​
Prerequisites

You need Bun installed (v1.2+): 
curl -fsSL https://bun.sh/install | bash

​
Setup

1

Install the CLI

From the Trilo monorepo:
cd packages/cli && bun link
This makes the trilo command available globally.Verify it works:
trilo --version
2

Log in

trilo login
Your browser opens to authorize the CLI. Click Authorize and you’re done — the token is stored securely and refreshes automatically.
For CI/CD or scripting, use a Personal Access Token instead.
3

Try it out

# List your projects
trilo projects list

# List tasks in a project
trilo tasks list --limit 5

# Get JSON output for scripting
trilo tasks list --limit 100 --json | jq '.data | length'
4

Install shell completions

Tab completion for all commands and flags:
trilo completions install
Restart your shell, then try trilo tasks <tab> to see completions.

​
What’s Next?

Authentication

OAuth login, PAT tokens, CI/CD setup, and environment variables.

Commands Reference

All 19 commands with examples and scripting patterns.

​
Common Workflows

​
Quick task check

trilo tasks list --status in_progress

​
Create a task from terminal

trilo tasks create --title "Fix login bug" --project-id <id> --priority high

​
Pipe JSON to other tools

# Export project list as CSV
trilo projects list --json | jq -r '.data[] | [.name, .id] | @csv'

# Count blocked tasks
trilo tasks list --status blocked --json | jq '.data | length'

​
Trigger a workflow

trilo workflows run --page-id <workflow-page-id>
trilo workflows status --page-id <workflow-page-id>

​
Troubleshooting

The CLI needs port 9876 for the OAuth callback. Check what’s using it:
lsof -i :9876
Kill the process or wait for it to finish, then retry trilo login.
Your token may have expired and refresh failed. Run trilo login again to get a fresh token.If using a PAT, check that TRILO_TOKEN is set correctly and the token hasn’t been revoked.
Make sure you have the right workspace selected:
trilo workspace current
trilo workspace list
trilo workspace set <correct-workspace-id>
Check that you can reach the API:
curl -s https://api.trilo.chat/health
If using a custom API URL, verify TRILO_API_URL is correct.