Commands | GigLabo

Core Commands

Command	Description
`heretic-cli init`	Interactive setup wizard for global settings and agent profiles
`heretic-cli local-init [profile]`	Scaffold per-project configuration
`heretic-cli run <agent>`	Start an agent container
`heretic-cli ps`	List running agent containers
`heretic-cli stop [name]`	Stop running containers
`heretic-cli attach <name>`	Attach to a running container's TTY
`heretic-cli agents`	Manage global agent profiles

Utility Commands

Command	Description
`heretic-cli local-validate [profile]`	Validate local configurations
`heretic-cli doctor`	Run environment health checks
`heretic-cli update`	Check for and install CLI updates

Global Options

-v, --version       Show version
-V, --verbose       Enable verbose (debug) logging
--log-file <path>   Write logs to a file

Shorthand

Any unknown command is treated as run:

heretic-cli claude            # Same as: heretic-cli run claude
heretic-cli claude -d         # Same as: heretic-cli run claude -d
heretic-cli claude -s feature # Same as: heretic-cli run claude -s feature

Detailed Command Pages

heretic-cli init — Setup wizard and token security
heretic-cli local-init — Per-project scaffolding
heretic-cli run — Running agent containers
heretic-cli agents — Profile management
heretic-cli ps, stop, attach — Container lifecycle