Skip to main content

Crate leviath_cli

Crate leviath_cli 

Source
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 lev binary, 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 Commands enum and the dispatch() function that routes a parsed subcommand to its executor.
held_checkpoints
What still stops a --yolo run for a person.
lint
Blueprint lint: the checks Blueprint::validate deliberately does not make.
logging
Process-wide logging: the subscriber main installs, 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 Text renderer.
runstate
On-disk run state for background agent executions.
shell_keys
Turning a shell command line into the keys a grant is remembered under.
tool_inventory
What tools an agent on this machine can actually use, and where each one came from.
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.