Document the production repository import release

Document the production repository import release

Deploy story

What this commit did to the running system — joined from the forge receipt chain, the part a commit page elsewhere cannot show.

Not deployed through the forge lane

No push, promotion, build, or deploy receipt references this commit (receipts are scanned over a bounded recent window). Changes shipped by full node replacement carry their proof in the release gate receipt instead.

Changed files

modified docs/openagents-cli/import-github.md
modified docs/openagents-cli/index.md
modified docs/openagents-cli/install.md

Diff

3 files changed, +42 -9

66	66		`after the server accepts the durable import. A client timeout does not cancel`
67	67		`the server-side import.`
68	68
	69	+	`## Verify the first production import`
	70	+
	71	+	`Use a small private GitHub repository for the first production import. Include`
	72	+	`a second branch and an annotated tag so you can verify the accepted ref`
	73	+	`snapshot. If the repository uses Git LFS, expect OpenAgents to preserve the`
	74	+	`pointer files without copying the LFS objects.`
	75	+
	76	+	`1. Install the qualified CLI version:`
	77	+
	78	+	```sh
	79	+	`npm install --global @openagentsinc/cli@0.1.0`
	80	+	```
	81	+
	82	+	`2. Sign in to production and confirm the selected account:`
	83	+
	84	+	```sh
	85	+	`openagents --profile production auth login`
	86	+	`openagents --profile production auth status`
	87	+	```
	88	+
	89	+	`3. Start one private import and wait for the durable result:`
	90	+
	91	+	```sh
	92	+	`openagents --profile production repo import OWNER/REPOSITORY --private --wait-timeout 300`
	93	+	```
	94	+
	95	+	`4. Confirm that the repository is ready, then clone it:`
	96	+
	97	+	```sh
	98	+	`openagents --profile production repo view OWNER/REPOSITORY`
	99	+	`openagents --profile production repo clone OWNER/REPOSITORY`
	100	+	```
	101	+
	102	+	`5. Compare the cloned branches and tags with the accepted GitHub snapshot.`
	103	+	`Confirm that a later GitHub commit does not appear in the OpenAgents copy.`
	104	+
	105	+	`The release process does not create a production repository automatically.`
	106	+	`An authenticated operator starts the first production import explicitly.`
	107	+
69	108		`## What the import copies`
70	109
71	110		`\| Copied \| Not copied \|`

103	142
104	143		`- [Clone, push, and pull](git.md)`
105	144		`- [CLI command reference](command-reference.md)`
106		-

from a terminal. It uses the same repository API as the OpenAgents web
interface and leaves Git data transfer to standard Git.

The CLI is implemented and locally verified. The production release remains
gated while OpenAgents completes staging qualification.
The CLI is available from npm. OpenAgents qualified repository imports on
staging before deploying the same server revision to the production fleet.

## What you can do


71	71		`- [Import a GitHub repository](import-github.md)`
72	72		`- [Clone, push, and pull](git.md)`
73	73		`- [CLI command reference](command-reference.md)`
74		-

# Install the OpenAgents CLI

The npm package is `@openagentsinc/cli`, and it installs the `openagents`
command. The package requires Node.js 24 or later.

The production npm release remains gated. The install command below applies
after the package is published.
command. The package requires Node.js 24.15 or later.

## Install with npm


150	147		`- [Create a repository](create-repository.md)`
151	148		`- [Clone, push, and pull](git.md)`
152	149		`- [CLI command reference](command-reference.md)`
153		-

4	4		`from a terminal. It uses the same repository API as the OpenAgents web`
5	5		`interface and leaves Git data transfer to standard Git.`
6	6
7		-	`The CLI is implemented and locally verified. The production release remains`
8		-	`gated while OpenAgents completes staging qualification.`
	7	+	`The CLI is available from npm. OpenAgents qualified repository imports on`
	8	+	`staging before deploying the same server revision to the production fleet.`
9	9
10	10		`## What you can do`
11	11

1	1		`# Install the OpenAgents CLI`
2	2
3	3		The npm package is `@openagentsinc/cli`, and it installs the `openagents`
4		-	`command. The package requires Node.js 24 or later.`
5		-
6		-	`The production npm release remains gated. The install command below applies`
7		-	`after the package is published.`
	4	+	`command. The package requires Node.js 24.15 or later.`
8	5
9	6		`## Install with npm`
10	7