CLI — status

aynig status [branch|pattern] [options]

aynig status prints the current branch state as derived from HEAD, or inspects specific local branches without checking them out.

It is a read-only command intended for quick inspection and debugging.

Behavior

Prints the inspected branch name and HEAD commit hash.
Reads the latest commit trailers and reports dwp-state and dwp-run-id.
When the current state is working, also reports dwp-origin-state when present.
Computes lease status as active, expired, unknown, or n/a.
Resolves the command path for the current state, or for dwp-origin-state when the current state is working.
Uses command: lease when the current commit is working but there is no origin state to resolve.
Prefers .aynig/roles/<role>/command/<state> over .aynig/command/<state> when a role is provided.
With --branch or a positional branch name, inspects that branch directly.
With --branch-pattern or a positional glob such as "1-*", prints one status block per matching branch.
When no branch selector is provided, preserves the current HEAD-based behavior.

Options

`--role <name>`

Checks the role-specific command directory first when resolving the command for the current state. If omitted, AYNIG falls back to ROLE when it is set.

Example:

aynig status --role reviewer

`--branch <name>`

Inspects a specific local branch without checking it out.

Example:

aynig status --branch 1-bootstrap

`--branch-pattern <pattern>`

Inspects all local branches that match the given glob pattern.

Example:

aynig status --branch-pattern "1-*"

Output

The command prints lines in this shape:

branch: <branch>
head: <commit>
dwp-state: <state>
dwp-origin-state: <state>
dwp-run-id: <run-id>
lease: <status>
command: <exists|missing|lease>
command-path: <path>

Some lines appear only when the related data exists.

Examples

Inspect the current branch:

aynig status

Inspect one branch directly:

aynig status 1-bootstrap

Inspect multiple branches with a pattern:

aynig status "1-*"

Resolve commands using a role-specific command directory:

aynig status --role reviewer

Use the environment variable form for role selection:

ROLE=reviewer aynig status