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

​
Prerequisites

You need Bun installed (v1.2+):

​
Setup

1

Install the CLI

From the Trilo monorepo:
This makes the trilo command available globally.Verify it works:
2

Log in

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

4

Install shell completions

Tab completion for all commands and flags:
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

​
Create a task from terminal

​
Pipe JSON to other tools

​
Trigger a workflow

​
Troubleshooting

The CLI needs port 9876 for the OAuth callback. Check what’s using it:
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:
Check that you can reach the API:
If using a custom API URL, verify TRILO_API_URL is correct.