Forge CLI
The Forge CLI is the operator-facing workflow for creating identities, scaffolding tools, running agents, and checking release readiness.
Intended command groups
| Group | Purpose |
|---|---|
forge identity |
Create, derive, inspect, and verify OAS identities. |
forge tool |
Scaffold and validate tool definitions. |
forge run |
Start an agent run with configured provider, tools, and identity. |
forge brew |
Validate and resolve Brew graphs. |
forge conformance |
Run local conformance scenarios. |
forge release |
Execute release-gate checks before deployment. |
Current status
The public docs describe the desired CLI workflow, but the release gate remains the source of truth for what is shippable today. Do not treat a command as stable until the corresponding SDK implementation and tests are present.
Good CLI behavior
CLI output should be:
- deterministic enough for tests
- structured where automation needs it
- explicit about development identities versus production roots
- clear when an operation is blocked by missing provider credentials or ACTs
- safe by default around secrets and key material
See Release Gate for the checks that should run before publishing CLI behavior.