CLI reference

Govern agent work from the terminal first.

The CLI is the fastest way to generate Aegisure.md, scan risky diffs, export cross-agent memory files, capture provenance, and create constrained repair prompts.

Install

pip install aegisure
aegisure --help

aegisure init

init

Scan the repository and generate the canonical Aegisure.md Constitution.

Usage

aegisure init

Example

aegisure init

aegisure export

export

Export Aegisure.md into the standard rule files used by coding agents.

Usage

aegisure export

Example

aegisure export

aegisure scan

scan

Analyze staged, changed, or committed diffs for critical risk and policy violations.

Usage

aegisure scan --staged [--json]

Example

aegisure scan --staged

aegisure repair

repair

Create a constrained prompt that tells an agent exactly what to fix.

Usage

aegisure repair --staged --agent <agent>

Example

aegisure repair --staged --agent codex

aegisure commit

commit

Commit changes while recording declared agent provenance and the originating prompt.

Usage

aegisure commit -m "<message>" --agent <agent> --prompt "<prompt>"

Example

aegisure commit -m "Fix auth redirect" --agent codex --prompt "Repair OAuth callback handling"

aegisure doctor

doctor

Run a read-only readiness check for Constitution drift, ignored secrets, and CI setup.

Usage

aegisure doctor

Example

aegisure doctor

aegisure run

run

Start or end a snapshot-and-scan session around normal agent work.

Usage

aegisure run [--end]

Example

aegisure run
# work with your agent
aegisure run --end

aegisure rewind

rewind

Safely prepare a git-based rollback for the last Aegisure-attributed change.

Usage

aegisure rewind last

Example

aegisure rewind last

aegisure login

login

Authenticate the CLI to a workspace, or keep using local mode with SQLite.

Usage

aegisure login

Example

aegisure login