Skip to main content
The TinyFish CLI lets you run browser automations, check results, and manage runs from your terminal — no code required.

​
Installation

npm install -g @tiny-fish/cli
Verify: 
tinyfish --version

​
Authentication

tinyfish auth login
Opens the API keys page in your browser. Paste your key when prompted. The key is saved to ~/.tinyfish/config.json. For CI/CD: 
echo $TINYFISH_API_KEY | tinyfish auth set
Check status: 
tinyfish auth status
Returns JSON with source (env, config, or none), key_preview (first/last chars of the key, or null), and authenticated (true/false). Exit code 1 when not authenticated.

​
Environment variables

VariableDescription
TINYFISH_API_KEYAPI key — takes priority over saved config

​
Output

By default all commands output JSON to stdout. Errors go to stderr as JSON. Exit code 1 on failure. Add --pretty to any command for human-readable output.