ephem-debugger-rs

Dev-only observability middleware for Rust web frameworks. Part of the debugger project.

Captures HTTP requests, tracing output, and browser-side data from your dev server. AI agents query this data through the dbg CLI.

Preview — under active development.

Install

[dependencies]
ephem-debugger-rs = { version = "0.1", features = ["axum"] }

Available features: axum, actix, rocket, poem

Axum

use ephem_debugger_rs::axum_middleware::DebuggerLayer;

let dbg = DebuggerLayer::new(3000).await;
let app = Router::new()
    .route("/", get(handler))
    .layer(dbg);

Actix-web

use ephem_debugger_rs::actix_middleware;

let dbg = actix_middleware::init(8080).await;
App::new()
    .wrap(dbg.middleware())
    .configure(|cfg| dbg.browser_config(cfg))

Rocket

use ephem_debugger_rs::rocket_middleware;

let dbg = rocket_middleware::init(8000).await;
rocket::build()
    .attach(dbg.fairing())
    .mount("/", dbg.browser_routes())

Poem

use ephem_debugger_rs::poem_middleware;

let dbg = poem_middleware::init(3000).await;
let app = Route::new()
    .at("/", get(handler))
    .with(dbg.middleware());

Query with CLI

npx dbg status
npx dbg server console
npx dbg browser console
npx dbg browser network

How it works

Middleware captures HTTP request/response metadata and tracing output
IPC bridge exposes data via Unix socket (or TCP on Windows)
Browser client script is auto-injected into HTML responses
dbg CLI queries the session — works the same across all languages

Other languages

Node.js — @ephem-sh/debugger
Go — ephem-debugger-go
Python — ephem-debugger-py

License

MIT

ephem-debugger-rs 0.3.3