ps, stop, attach
List running containers, stop agents, and attach to container TTY sessions
heretic-cli ps
List running agent containers.
heretic-cli ps # List all containers
heretic-cli ps --json # JSON output
heretic-cli ps -s feature-x # Filter by session name
heretic-cli stop
Stop running agent containers.
heretic-cli stop claude # Stop a specific agent
heretic-cli stop --all # Stop all heretic-cli containers
heretic-cli stop claude --keep # Stop but don't remove the container
heretic-cli stop claude -f # Skip confirmation
heretic-cli stop -s feature-x # Stop container(s) in a specific session
heretic-cli attach
Attach to a running agent container's TTY.
heretic-cli attach claude # Attach to default session
heretic-cli attach claude -s feature-x # Attach to session-specific container
Other Utility Commands
heretic-cli local-validate
Validate local .heretic/cli/ configuration(s) against their parent profiles.
heretic-cli local-validate # Validate all local configs
heretic-cli local-validate claude # Validate just the claude local override
heretic-cli doctor
Run environment health checks (Docker availability, profile validity, etc.).
heretic-cli doctor
heretic-cli doctor --fix # Auto-fix issues where possible
heretic-cli update
Check for and install CLI updates. If installed via npm/bun, directs you to use bun update -g @giglabo/heretic-cli instead.