CLI — run

aynig run [options]

aynig run inspects the current repository, resolves the command for the current DWP state, and executes the workflow for the branches it selects.

It is the main entry point for processing AYNIG state transitions.

Behavior

Uses .worktrees by default for worktree management.
Resolves the remote from --remote when provided.
If --remote is omitted, AYNIG checks the latest commit trailer dwp-source: git:<name> and uses that remote when present.
--current-branch controls whether the current branch is skipped, included, or used as the only branch.
In remote mode, current-branch resolution is based on the upstream branch of the current local branch, such as origin/main.
--role and ROLE make AYNIG check .aynig/roles/<role>/command/<state> before .aynig/command/<state>.
Log level precedence is --log-level > dwp-log-level trailer > LOG_LEVEL > default error.
Command stdout and stderr are written to separate files: .aynig/logs/<commit-hash>.stdout.log and .aynig/logs/<commit-hash>.stderr.log.
The command receives those paths in STDOUT_LOG_PATH and STDERR_LOG_PATH.
AYNIG watches stdout for lines that begin with SET_STATE and applies the last valid one after the command exits successfully.
If the command exits non-zero, AYNIG marks the branch as stalled with a diagnostic body that includes the exit code and recent log lines.
If the command exits zero without a valid SET_STATE, AYNIG writes a fresh working commit and keeps the lease alive.

Sets the directory where AYNIG creates and manages worktrees. The default is .worktrees.

Example:

aynig run --worktree .aynig-worktrees

Runs against branches discovered from the named remote instead of using only local branches.

Example:

aynig run --remote origin

Prefers role-specific commands from .aynig/roles/<name>/command when present.

Example:

aynig run --role reviewer

Controls how the current branch is handled. Supported values are skip (default), include, and only.

Example:

aynig run --current-branch include

Sets the runner log level. Supported values are debug, info, warn, and error.

Example:

aynig run --log-level debug

Run with the default local-branch behavior:

aynig run

Run with a specific role:

aynig run --role reviewer

Run against remote branches:

aynig run --remote origin

Run only the current branch:

aynig run --current-branch only

Run with a custom worktree directory and verbose logging:

aynig run --worktree .aynig-worktrees --log-level debug

Use the environment variable form for role selection:

ROLE=reviewer aynig run