Git

The hanzo git commands.

Also for this capability: API · CLI · MCP · SDKs

Git hosting for your org: create repos, clone, push, and see what they cost.

API reference →

hanzo git list

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

CommandWhat it does
hanzo git activityAnswers the estate's last 365 days: distinct commits, merges, active repositories and contributors, for the whole estate, each group and each org, a commit count per day, the newest public commits, and one page of public repositories.
hanzo git exploreDiscover public repositories across every org
hanzo git linkLinks every repository of the caller's org that holds no history here and names no link to github.com/<owner>/<name>, where GitHub lets the caller read it.
hanzo git listBrowse your org's repositories
hanzo git runnersReturns the daemons registered into this org's pools, newest first, with when each was last heard from.
hanzo git usageReturns per-repo and total storage bytes for the caller's org — the queryable, per-tenant number commerce and o11y meter on.
hanzo git webhookRetired — push-to-deploy has no inbound webhook
hanzo git workflowsReports the workflows a repository declares at a ref and which declared pool would execute each job — the answer to "would a push here run, and where".
hanzo git workspaceSets the org's code workspace up for the caller and answers it: the namespace, made when the org has none, and the caller's forge account and seat there.
hanzo runner declareRepublishes what a registered runner can do, and answers with what this side understands, so the two learn about each other from one exchange.
hanzo runner logAdds console output to a task's log and answers with how far that log is durable, so the runner knows where to resend from.
hanzo runner registerTrades a pool's join secret for a runner identity and the token that authenticates every later call.
hanzo runner stateRecords a task's progress and that of its steps, and answers with the result this side now holds — which is how a runner learns its task was stopped from somewhere else.
hanzo runner taskHands the runner a job to execute, if its pool has one, and answers immediately either way.

Org

CommandWhat it does
hanzo git org commits <org> <repo>Read a repository's commit log
hanzo git org get <org> <repo>Open a repository's home page
hanzo git org git-receive-pack <org> <repo>Accept a push, and turn it into a build
hanzo git org git-upload-pack <org> <repo>Serve a clone or fetch
hanzo git org info refs <org> <repo>Advertise a repository's refs to a git client
hanzo git org project git-receive-pack <org> <project> <repo>Accept a push, and turn it into a build
hanzo git org project git-upload-pack <org> <project> <repo>Serve a clone or fetch
hanzo git org project info refs <org> <project> <repo>Advertise a repository's refs to a git client

Pools

CommandWhat it does
hanzo git pools createRecords the capacity an org has, and answers with the secret a runner daemon presents to enter it.
hanzo git pools getReturns the capacity this org has declared and how many daemons have entered each pool.

Repos

CommandWhat it does
hanzo git repos blob <name>Returns one file's bytes at one revision.
hanzo git repos commits <name>Walks a ref's history newest first, or one path's history when a path is given.
hanzo git repos createProvisions an empty bare repository in the caller's scope and returns it with its clone URLs.
hanzo git repos files <name>Returns every file a glob selects at one revision, WITH its bytes and the revision they came from.
hanzo git repos gc <name>Repacks a repo into one bitmapped pack and rewrites its commit-graph, so the next clone reuses the bitmap instead of walking the whole object graph.
hanzo git repos get <name>Returns one repo with its live ref state: every branch name and the resolved HEAD commit.
hanzo git repos home <name>Moves a repository whose history is HERE to the forge (git.hanzo.ai), the one home of a repository no other host holds, and links it there: the repository is made in the org's own namespace on the forge, every branch and tag is pushed to it, the forge's refs are read back and must equal these, and only then does the row name the forge as its link, so this copy becomes the cache it can be fetched back into.
hanzo git repos link <name>Records that a repository's history lives on another host, making the repository first when the org has none of that name.
hanzo git repos listReturns the repos in the caller's scope, most recently updated first.
hanzo git repos pulls create <name>Proposes a branch for merging and returns it with its number.
hanzo git repos pulls get <name> 1Returns one pull request by its per-repo number.
hanzo git repos pulls list <name>Returns a repo's pull requests, newest number first — what is waiting to be reviewed, and what has already landed.
hanzo git repos pulls merge <name> 1Merges an open pull request by FAST-FORWARDING base to head, and answers the proposal in its merged state with the revision base now points at.
hanzo git repos push <name>Lands a set of files as one commit without a git client — the hanzo.app builder's push.
hanzo git repos readme <name>Returns the README at the tree root as plain text — unrendered, so the caller decides how to present it.
hanzo git repos refs <name>Lists a repo's branches, tags and default branch — what a branch picker needs in one call.
hanzo git repos rm <name>Removes a repo's metadata and purges its storage.
hanzo git repos subscriptions create <name>Binds a Slack channel to a repo, so the lifecycle notifier posts that repo's push and deploy events there.
hanzo git repos subscriptions list <name>Returns a repo's Slack subscriptions — which channels the lifecycle notifier posts this repo's push and deploy events to.
hanzo git repos subscriptions rm <name> <id>Removes one Slack subscription from a repo; the notifier stops posting that repo's events to that channel.
hanzo git repos targets create <name>Registers a downstream remote the repo's advanced refs are pushed to whenever a push lands here.
hanzo git repos targets list <name>Returns a repo's outbound mirror targets — the downstream remotes the mirror reactor pushes to whenever a push lands here.
hanzo git repos targets rm <name> <id>Removes one outbound mirror target; later pushes stop being forwarded to it.
hanzo git repos tree <name>Lists the immediate children of one directory at one revision, directories before files.
hanzo git repos update <name>Flips a repo's public bit, the one mutable repo setting today.

Runs

CommandWhat it does
hanzo git runs createRuns a repository's workflows at a ref, on demand.
hanzo git runs get <id>Returns one run.
hanzo git runs listReturns this org's runs, newest first.
Was this page useful?
Broken link or missing step? Drop it in #docs on Discord or open a PR.