Command reference

Every command prints its full options with --help, for example weld work declare --help. weld --help lists them all. Most commands that print data accept --json.

Status and your Work

Command	What it does
weld status	Hub link, project, your Work, handoffs, inbox, and what to do next
weld work list [--mine] [--all] [--state …]	Live Work in the project (proposed, active, idle, ready); --all adds merged and closed
weld work declare "<title>" [-s summary] [--why …] [--approach …] [-p path]… [--scope …]… [--gdd …]…	Declare the feature you’re working on; re-declaring the same title adds scopes
weld work show <id>	One Work item in full
weld work take <id>	Take a proposed item, such as a handoff for you
weld work ready [id]	Finished: ready to merge (alias weld work done)
weld work close [id] [--reason …] [--abandon]	Close without merging; reopenable
weld work reopen <id>	Reopen ready, closed or abandoned Work

Coordinating

Command	What it does
weld overlap list [work]	Overlaps between your Work and teammates’, with what to decide
weld overlap ack "<their work>" --decision coordinate|proceed|pivot [--note …]	Record your decision
weld handoff "<what>" --to <person> [--summary …] [--work <id>]	Hand work to a teammate as a proposed Work item
weld msg <person> "<text>" [--work <id>]	Send a teammate a short message
weld inbox [--all] [--keep-unread]	Messages and handoffs sent to you

Merging

Command	What it does
weld merge [work] [--commit] [-m message] [--branch …]	Push and queue your Work for the merge queue
weld merge list [--all]	Merges waiting for a human, and recent outcomes
weld merge approve <merge id>	Land an AI-resolved merge after reviewing it
weld merge override <merge id>	Merge despite the critic gate (humans only)
weld agents critique [--rubric …] [--critics N]	Run one critic round and record the scores on your Work
weld agents targets [dim=score …] [--require-critic true|false]	Show or set the project’s critic merge-gate targets

Joining and this machine

Command	What it does
weld node [<join url>] [--hub <url>] [--roles …]	Sign this machine in to a hub (see Getting started)
weld clone "<project>/<repo>" [dir]	Clone a hub repo with credentials and LFS set up
weld node link [--t1-command "<tests>"]	Link a checkout to a project; set this node’s T1 test command
weld git setup [--push]	Configure a repo for the hub: credential helper, remote, LFS, .gitattributes
weld node status / weld node caps	This node’s config and connection / its capabilities
weld node role add|rm|list <role>	Roles that route jobs to this node (build, gpu, …)
weld node install-service / uninstall-service	Run the node at login, or stop doing so
weld node run [--offline]	Run the node daemon in the foreground
weld node telemetry --prompts|--no-prompts	Whether prompt text and tool details are shared with the hub’s ops view
weld node repair	Redo this machine’s setup from its saved config
weld node leave	Undo the join and remove this machine’s Weld config, key and cache
weld setup [--roles …] [--yes] [--no-install]	Install what this machine needs, showing every command first
weld login	Open the web dashboard, signed in
weld auth whoami / weld auth refresh	Who this machine is signed in as / replace its device token
weld update [--check] [--rollback]	Update weld from the hub’s signed release channel, or roll back

Projects and people

Command	What it does
weld project list / weld project members	Your projects / a project’s members and roles
weld project create "<name>"	Create a project you own and link the current repo
weld invite <email> [--role member|owner]	Invite a teammate: an email-bound hub invite plus a welcome email with the install steps
weld invite list [--all] / weld invite revoke <id|email>	Pending invites / cancel one
weld repo list	Git repos hosted on the hub for a project

Trust, jobs and secrets

Command	What it does
weld node keys	Your key fingerprint, trusted keys and keys the hub offers
weld node trust <who> / untrust <who>	Trust a teammate’s key after comparing fingerprints
weld node policy show / allow-web-assets / deny-web-assets	This node’s local job policy
weld jobs submit <kind> [-p key=value]… [--role …] [--os …] [--wait]	Submit a signed job
weld jobs list [--state …] / show <id> / logs <id> [-f] / cancel <id>	Follow jobs
weld jobs approve <id>	Approve a teammate’s job on this machine (you, in your terminal)
weld secret set|list|rm <NAME>	Project secrets leased to jobs

Game, assets and shipping

Command	What it does
weld game new <Name> [--style stylized|realistic|lowpoly] [--push]	Create an Unreal C++ game wired for Weld
weld game build / smoke / package / open / engines	Build, test, package and open the project
weld game doctor [--fix]	Check and repair the project’s Unreal MCP setup
weld asset make "<prompt>" [--kind …] [--tris …] [--image …] [--gpu auto|local|remote]	Run the asset pipeline
weld asset status <dir> / show <id>	A local run / an asset on the hub
weld asset gate <id> concept|mesh|engine --approve|--reject|--regenerate [--note …]	Decide a gate
weld ship [--channel windows|mac] [--dry-run]	Package, smoke-test, zip and upload to itch.io
weld ship init --itch <user>/<game> / butler / video	Set up and record for shipping

Packs and agents

Command	What it does
weld pack list / add <name> / publish <dir> / validate <dir>	Knowledge, workflow and agent packs
weld agents list / schedule / approve <agent> / run <agent>	Background agents
weld agents jam on|off|status	Pause non-critical agents

Health and help

Command	What it does
weld doctor [--fix] [--ai] [--bundle] [--share] [--only …]	Check this machine, fix what’s safe, debug the rest with Claude
weld ops health / logs / traces <id> / costs [--by user|agent|model|node|session]	Hub health, logs, traces and Claude costs
weld feedback "<text>" [--bundle <dir>]	Report friction with Weld
weld cache prune [--dry-run]	Free disk used by Weld’s caches
weld help t1	How the T1 test gate works
weld --safe <command>	Start with hooks, jobs and plugins disabled