Crate autom8 

autom8 - CLI tool for orchestrating Claude-powered development.

autom8 bridges the gap between product requirements (specs) and working code by driving Claude through iterative implementation of user stories.

Core Workflow

1. Define features as structured user stories with acceptance criteria
2. autom8 orchestrates Claude to implement each story
3. Reviews for quality and iterates as needed
4. Commits changes and creates GitHub PRs

Modules

• commands - CLI command handlers
• runner - Main orchestration loop
• claude - Claude CLI integration
• gh - GitHub CLI integration
• output - Terminal output formatting
• state - State machine and persistence
• config - Configuration management
• spec - Spec/user story structures

Re-exports

pub use display::BannerColor;

pub use display::StoryResult;

pub use error::Autom8Error;

pub use error::Result;

pub use progress::Breadcrumb;

pub use progress::BreadcrumbState;

pub use progress::ProgressContext;

pub use runner::Runner;

pub use snapshot::FileMetadata;

pub use snapshot::SpecSnapshot;

pub use spec::Spec;

pub use state::MachineState;

pub use state::RunState;

pub use state::RunStatus;

pub use state::SessionMetadata;

pub use state::SessionStatus;

pub use state::StateManager;

Modules

claude

Claude CLI integration for autom8.

commands

CLI command handlers for autom8.

completion

Shell completion infrastructure for autom8.

config

display

Display output types for autom8.

error

gh

GitHub CLI integration for PR operations.

git

knowledge

Project knowledge tracking for cumulative context across agent runs.

output

Terminal output formatting for autom8.

progress

prompt

prompts

runner

self_test

Self-test spec for testing autom8 itself.

signal

Signal handling infrastructure for graceful shutdown.

snapshot

Spec file snapshot functionality for detecting new files after Claude sessions.

spec

state

ui

UI module for autom8.

worktree

Git worktree operations for autom8.