Skip to content

README.md

Latest commit

 

History

History
115 lines (88 loc) · 4.73 KB

README.md

File metadata and controls

115 lines (88 loc) · 4.73 KB

enchanter-inspector

Enchanter Inspector — terminal cockpit for the Enchanter AI runtime

Terminal-first TUI cockpit for the Enchanter AI runtime — think htop / btop / k9s / lazygit, but for an AI agent runtime.

Terminal is the cockpit. Web/Electron is the studio.

The inspector consumes the runtime's JSONL event stream and renders a live, navigable view of plugins, events, security, cost, drift, codebase impact, replay, runtime internals, and task graph. Lives inside the Enchanter monorepo as the Rust-side dashboard.

Install / build

This is a Rust crate inside the Enchanter monorepo at client/enchanter/inspector/. From this directory:

cargo build --release

The binary lands at target/release/enchanter (so enchanter inspect becomes one short command on PATH).

Usage

The default mode reads newline-delimited JSON events from stdin — pipe the runtime in:

enchanter-runtime | enchanter

Replay a previously captured run:

enchanter --from ./run-2026-04-30.jsonl
# or via the explicit subcommand:
enchanter inspect --from ./run-2026-04-30.jsonl

Connect to a live runtime socket:

enchanter --socket 127.0.0.1:7878
# or unix socket
enchanter --socket /tmp/enchanter.sock

Try it without a runtime

A bundled fixture replays a realistic session covering every event variant. The demo_emit example paces lines by the time field on each event so the dashboard animates the way it would under live load:

cargo run --example demo_emit | cargo run
# faster replay
cargo run --example demo_emit -- --speed 4 | cargo run
# instant blast
cargo run --example demo_emit -- --speed 0 | cargo run

stdout is reserved for forwarding events to downstream tools; all log output is written to a file under $XDG_CACHE_HOME/enchanter/inspector.log (or the platform equivalent).

Key bindings

Key Action
q Quit
p Pause / resume the live event stream
/ Open filter / search
? Toggle help overlay
Tab Cycle to the next view
Enter Drill into the highlighted row
Esc Cancel filter / close overlay / pop drill-down
1 Overview
2 Plugins
3 Events
4 Security
5 Cost
6 Drift
7 Codebase
8 Replay
9 Runtime
0 Tasks
v Toggle verbose / detail panel
c Copy highlighted row (id, path, or quote) to clipboard
d Diff the highlighted artifact against its baseline
r Refresh / reload current view
e Export current view to a file
a Acknowledge / dismiss the highlighted alert

Plugins

The inspector tracks the ten Enchanter plugins, each with a stable accent color used in the UI:

Plugin Accent
pech orange
emu yellow
hydra green
sylph cyan
lich blue
naga green
crow yellow
djinn purple
gorgon pink
wixie magenta

Architecture

  • src/event/ — wire types for the JSONL event stream
  • src/transport/ — stdin / file / socket source adapters
  • src/state/ — application + per-plugin state, derived views
  • src/app/ — main loop, terminal lifecycle, input handling
  • src/ui/ — shared theme, widgets, layout primitives
  • src/views/ — one module per top-level screen

See the parent monorepo README for how the inspector relates to enchanter-runtime, the enchanter Node CLI, and the broader plugin set.
⚡