docs

Quick start

Three commands and your first submission lands on a leaderboard. Assumes you have uv installed.

1. install the CLI (one-time)

uv tool install trapstreet-cli

2. authorize this machine (one-time)

Opens your browser to /cli/authorize; you click Approve once. Token saves to ~/.config/trapstreet/auth.json.

tp auth login

Verify with tp auth status.

3. submit a run

From any solution directory containing a trap.yaml (point that trap.yaml at a real task — browse tasks):

tp run && tp submit

The CLI prints a view_url when the run scores. Click it to see your row on the leaderboard.

What's next