dexuse: Instructions file for Codex

AGENTS.md

This repo is a Rust/Ratatui CLI packaged for npx @yashau/dexuse with a dexuse binary. Keep it fast, local-first, modular, and screenshot-polished.

Product promise

dexuse reads local AI usage stores and turns them into a fancy terminal dashboard plus JSON summaries. It must never upload user history or print secrets. Treat local session files, transcript text, database rows, and paths as sensitive. Usage totals are fine; raw prompts/messages are not.

Stack

• Rust CLI and TUI: src/
• TUI framework: Ratatui + Crossterm
• JSON output: src/output.rs
• Aggregation/model types: src/model.rs, src/aggregate.rs
• npm wrapper: scripts/dexuse.js
• screenshot harness: scripts/render_tui_screenshots.cjs
• deterministic usage fixtures: fixtures/usage/
• primary repo tool: mise (mise.toml pins Rust/Node and defines install, quality gates, build, bundle, screenshot, smoke, and packaging tasks)
• JS package manager: pnpm (packageManager is pinned in package.json)

Use mise first for repo workflows (mise install, mise run check, mise run screenshots, mise run pack). Use pnpm, not npm, when managing JS dependencies directly.

Quality gates

Before saying a change is done, run the relevant mise task subset. For user-facing, parser, fixture, or packaging changes, run the primary gate and any artifact-specific tasks:

mise install
mise run check
mise run screenshots
mise run pack

Underlying commands, useful when isolating a failing step:

cargo fmt --check
python scripts/smoke_json.py
cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo build --release
python scripts/bundle_current.py
pnpm run screenshots
pnpm pack --dry-run

Notes:

• Rebuild release before trusting pnpm exec dexuse or screenshot output. The JS wrapper may prefer bin/dexuse-<platform>-<arch>.
• scripts/with_timeout.py is the preferred timeout wrapper in automation.
• Miri uses nightly. Hermes SQLite tests are ignored under Miri because SQLite/file FFI is not supported by Miri on Windows.