Expand description
Leviath CLI library - re-exports for integration tests.
missing_docs applies here like everywhere else in the workspace. This crate
ships the lev binary rather than a library anyone calls, so the case for
exempting it was real - and the case against turned out to be stronger: the
pub surface is what the integration tests drive, and a wire type like
commands::serve::ServerEvent is read by clients that never see this
source. An undocumented field there is a gap for somebody.
What the rule asks for is a sentence saying something the name does not. A
clap Args field already carries its user-facing text for --help; the
struct around it says which command it belongs to.
Modules§
- approvals
- What a run may do without asking anybody.
- bundled
- The agent blueprints shipped inside the
levbinary, and the planner that decides what to do with them. - commands
- CLI command implementations.
- config
- CLI configuration management.
- credentials
- Choosing and using the configured credential backend.
- daemon
- The shared-world daemon: hosts one ECS world for every agent and serves the
control socket. This module holds the CLI-side pieces that plug into the
runtime’s daemon library (
leviath_runtime::host,leviath_runtime::control_socket): the tool service that bridges tool calls to the built-in / MCP executors and the interaction hub. - dispatch
- Command dispatch: the
Commandsenum and thedispatch()function that routes a parsed subcommand to its executor. - held_
checkpoints - What still stops a
--yolorun for a person. - lint
- Blueprint lint: the checks
Blueprint::validatedeliberately does not make. - logging
- Process-wide logging: the subscriber
maininstalls, with a reloadable slot for the OTLP log-export layer. - read_
path_ report - Whether the user’s config actually grants what a blueprint’s
[read_paths]declares, entry by entry. - render
- Markdown → ratatui
Textrenderer. - runstate
- On-disk run state for background agent executions.
- shell_
keys - Turning a shell command line into the keys a grant is remembered under.
- tools
- Unified tool registry combining built-in tools and MCP-discovered tools.
- tui
- Seams shared by every Leviath terminal UI.
- workdir_
guard - Confirming a workdir that is somewhere an agent probably should not write.