---
id: STATE-WP-0055
type: workplan
title: "StateHub register CLI"
domain: infotech
repo: state-hub
status: finished
owner: codex
topic_slug: custodian
created: "2026-06-04"
updated: "2026-06-04"
state_hub_workstream_id: "eee82afc-a902-48a2-8187-8dae31d05300"
---

# StateHub register CLI

Implement a convenient `statehub register` command that can be run from an
established local repository to register it with State Hub and prime it for
Codex agent work.

## Implement register command

```task
id: STATE-WP-0055-T01
status: done
priority: high
state_hub_task_id: "83d14bd4-301e-4e8a-9a6c-5f6586c5b070"
```

Added a `statehub register` CLI entrypoint backed by `llm-connect` inference.
The command inspects the target repo, derives or confirms repo intent, creates
`INTENT.md` when absent, writes State Hub agent files and an initial workplan,
registers the repo and local host path through the State Hub API, and leaves
clear operator follow-up for `make fix-consistency REPO=<slug>`.
