cli & agents

Ship from a terminal. Or let your agent do it.

The Tinker CLI talks to our API only — no Docker credentials on your laptop. Paste a public HTTPS git URL, get a live *.tinkerers.space URL. Coding agents (Grok, Codex, Claude Code, Cursor, …) can follow the same path with an installable skill.

package

@tinkerers/cli

skill

tinker-cli

price

free deploys

01 · install

Get the CLI.

Node 18+. Global install is fine for agents and humans. Config lands in ~/.config/tinker/config.json.

npm

npm i -g @tinkerers/cli@latest
tinker --version

Package: @tinkerers/cli. Source: qKitNp/tinker-cli.

02 · login

Sign in once.

Browser login opens this site, then returns a session to a local callback. Agents and CI can skip the browser with a Supabase access token.

browser

tinker login
tinker whoami

agents / CI

tinker login --token "$SUPABASE_ACCESS_TOKEN" --no-browser
# or:
export TINKER_TOKEN='…'
tinker whoami

03 · deploy

Git URL in. Live URL out.

Deploys are free. Sign in, point at a public HTTPS git URL, and ship — no subscription or checkout step.

ship

tinker deploy https://github.com/org/repo.git
tinker status <deploy_id> --watch

04 · agent skill

Teach the agent the loop.

Install the tinker-cli skill from the skills.sh ecosystem so Grok, Codex, Claude Code, Cursor, and friends know login and deploy — without inventing Docker glue.

skills.sh

npx skills add qKitNp/tinker-cli@tinker-cli -g -y

# list skills in the repo
npx skills add qKitNp/tinker-cli -l

Skill source: skills/tinker-cli/SKILL.md. Browse the ecosystem at skills.sh.

default agent loop

  1. npm i -g @tinkerers/cli
  2. tinker login (or TINKER_TOKEN)
  3. tinker deploy <url>
  4. tinker status <id> --watch
  5. Return the live URL to the human

exit codes

Branch on the number.

Non-zero means something went wrong — read stderr and fix auth, network, or the API error.

0

success

Continue; deploy or report the live URL.

1

hard error

Read stderr; fix auth, network, or API error.

env

Optional overrides.

TINKER_API_URL

API base (default https://api.tinkerers.space)

TINKER_TOKEN

Supabase access JWT (overrides saved config)

TINKER_WEB_URL

Website for browser login (default https://tinkerers.space)

Prefer the dashboard?

Paste a GitHub URL in the UI — same free deploys, same live URLs.

ship nowgithub