[rig] — identity

[rig]
name        = "market-researcher"
author      = "maria"
version     = "1.2.0"
description = "Equity research workspace with yfinance + macro MCPs."
runtime     = "claude-code"

The only required section. All five fields must be strings, all must be present, no defaults.

Fields

`name`

Short identifier — lowercase, kebab-case, no spaces. Combined with author to form author/name, which is the canonical reference (hub:author/name, registry:author/name, etc).

Used as:

The default install directory name.
The Hub URL slug (userig.xyz/packages/author/name).
The collab binding default name (when [sync].name is omitted).

`author`

Your Hub username, or any string for non-Hub distribution. Used in author/name references and shown on the package page.

For Hub publishes, the author must match your authenticated user, or the publish will be rejected.

`version`

Semver string (MAJOR.MINOR.PATCH with optional pre-release suffix). The CLI parses it for ordering — non-semver versions are rejected on pack.

Bump it before publishing each new release. See Versioning.

`description`

One-line description (under ~140 chars). Shown in rig hub search results, the Hub home page, and the package metadata box.

`runtime`

The agent runtime this rig targets. Currently the only valid value is:

runtime = "claude-code"

Other runtimes are intentionally not yet supported. The field exists so that when they arrive, rigs can declare what they're for.

Examples

Minimum:

[rig]
name        = "hello"
author      = "you"
version     = "0.1.0"
description = "Hello world."
runtime     = "claude-code"

Pre-release:

[rig]
name        = "experimental-thing"
author      = "you"
version     = "0.1.0-alpha.3"
description = "WIP."
runtime     = "claude-code"

Validation errors

Error	Cause
`[rig] section is required`	Section missing.
`[rig].name is required`	Field missing or empty.
`[rig].version is not valid semver`	Doesn't match `\d+.\d+.\d+(?:-…)?`.
`[rig].runtime must be "claude-code"`	Other values not yet supported.