Crate seshat_cli 

Seshat CLI

CLI commands and TUI for developer interaction. Provides the human-facing interface to Seshat’s capabilities:

• seshat scan <path> — scan a project and display analysis report
• seshat serve — start MCP server for AI agent connections
• seshat status — show indexed projects, submodules, and database info
• seshat review — interactive TUI for convention review (stub)
• seshat init — generate MCP configuration for detected AI clients (stub)

Uses clap for argument parsing, indicatif for progress bars, and tracing-subscriber for log output.

Re-exports

pub use args::Cli;

pub use args::Command;

pub use db::find_git_root;

pub use db::get_current_branch;

pub use error::CliError;

pub use format::Verbosity;

Modules

args

Command-line argument definitions (clap derive types). Command-line argument definitions via clap derive.

completions

seshat completions — generate shell completion scripts. seshat completions — print a shell completion script to stdout.

config

Application configuration loading from seshat.toml.

dangerous_path

Per-OS dangerous-cwd denylist (see dangerous_path::is_dangerous_cwd). Dangerous-path denylist for seshat serve.

db

Shared database path utilities (XDG resolution, project name extraction). Shared database path utilities used by both scan and serve commands.

debug

Debug command: dump conventions with evidence snippets from the DB. seshat debug-snippets command — dumps every convention from the DB with full evidence for offline inspection.

decisions

Implementation of the seshat decisions subcommands. Implementation of the seshat decisions subcommands.

error

CLI error types. CLI error types.

format

Shared output formatting utilities (color, verbosity, bar charts, etc.). Shared output formatting utilities for CLI reports.

init

Implementation of the seshat init command. Implementation of the seshat init command.

instructions

Agent instruction file management (upsert, skill install, hooks). Agent instruction file management for seshat init.

report

Scan report rendering (overview, conventions, next steps). Scan report rendering.

review

Implementation of the seshat review command. Implementation of the seshat review command.

scan

Implementation of the seshat scan command. Implementation of the seshat scan <path> command.

serve

Implementation of the seshat serve command. Implementation of the seshat serve command.

status

Implementation of the seshat status command. Implementation of the seshat status command.

tui

TUI components for interactive convention review.

uninstall

Implementation of the seshat uninstall command. Implementation of the seshat uninstall command.

update

Implementation of the seshat update command.

version_cache

Version check cache utilities for self-update.

Functions

run

Parse CLI arguments, initialize logging, and dispatch to the appropriate command handler.