skip to content

CLI reference

Every terminalhire subcommand, grouped by what it's for. th works as a short alias everywhere you see terminalhire. Run terminalhire --help for the live, in-terminal version of this list.

Account

Command What it does
init One-command onboarding — start here
login Sign in with GitHub (enriches your profile instantly)
logout Clear the stored GitHub token
link Connect this terminal to your terminalhire account
link --logout Revoke this terminal's linked session
profile --show Display your encrypted local profile
profile --edit Set display name, contact email, preferences
profile --delete Wipe your profile and encryption key from disk
config --show Print current config
refresh Fetch the latest index + re-match, update the local cache
sync --push Opt-in: send your profile to staqs (typed-yes consent)
sync --status Show whether you've consented (local read)
sync --delete Hard-delete your synced profile (revocation)

Matching — see Getting started

Command What it does
jobs Fetch the index, browse roles matched to your profile
jobs --all / --page N / --limit N Page through the full ranked list
jobs --status <s> Filter by applied/saved/dismissed/clicked/unactioned
jobs mark <id> <status> Track your funnel — see Job statuses
save <jobId> / saved / unsave <jobId> Save, list, or remove a saved job

Credential — see Proof of Work

Command What it does
trajectory Trajectory from your local Claude Code corpus
trajectory --export Write a derived score + Markdown locally
trajectory --push Opt-in: link your trajectory to your dashboard (typed-yes)
contribute Feed of credential-building open issues (on by default; opt out with contributeEnabled: false)
contribute <owner/repo> Open, unassigned issues in ONE project you name, ranked to your stack; also adds the repo to the shared index

Bounties — see Bounties and claims

Command What it does
bounties [--priced] First-party founder bounties by default; --priced adds scraped paid open-source supply
claim preview <id|url> Read-only preview of a bounty before claiming
claim record <id|url> Claim a bounty locally; a founder posting is also registered server-side to your verified identity
claim attach <id> --worktree … --branch … Link a claim to your working branch
claim slice <id> Founder postings: fetch the shared file slice, contents included — no clone, no credential
claim submit <id> Open the PR from your fork — or, on a founder posting, submit the patch over HTTP (no fork)
claim runs <id> Founder postings: read the founder's own CI verdict on your submitted patch
claim status [<id>] Check founder approvals or poll source PR merge state
claim list [--active] Your claims + accepted-PR rate
claim release <id> Give up a claim
protocol register / unregister / status Wire (or unwire) th://claim/<token> links on this machine — see Claim links

Connect — see Connect

Command What it does
devs / devs --as-project Rank opted-in builders locally
project "<title>: <skills>" / project --show Declare or view a local project
intro <login> / intro --list / intro --accept @<login> Request, list, or accept intros
connect / connect --mute / connect --unmute Overview + toggle inbound nudges
chat / chat <login> --read / --send Inbox, read, or send in a connection thread
inbox Interactive inbox TUI

Surfaces — see Claude Code surfaces

Command What it does
spinner --show / --off / --mode append|replace Toggle and configure the spinner
statusline --on / --off Toggle the connection-only status line
mcp / mcp --print-config Run the MCP server; print host config — see MCP
config --nudge session|always|every:N Tune nudge frequency
config --connect on|off Opt in/out of ambient peer/founder surfacing
config set mix jobs|balanced|credential / config get mix Balance roles vs. contribution items on the surface (default balanced; env TH_MIX overrides)