sessionview: Instructions file for Codex

SessionView

Guidance for Claude Code (claude.ai/code) and other agents working in this repository. CLAUDE.md includes this file via @AGENTS.md.

SessionView is a desktop app that brings local AI coding sessions from many tools — Claude Code, Codex, Antigravity, Kimi Code, Cursor, OpenCode, CC-Mirror, Pi, Grok Build, DSH (DeepSeek Harness), MiniMax Code, GitHub Copilot CLI, and Command Code — into one place to read, search, analyze usage, export, and resume. Stack: Tauri 2 + React 19 (with React Compiler) + Rust + SQLite (FTS5). Enforcement-mapped coding standards live in style/ts.md and style/rust.md; when this file and those disagree, those win.

Commands

# App / frontend
npm run tauri dev        # run the app with hot reload
npm run tauri build      # production bundle

# Headless server (browser shell; build dist first so it can be embedded)
npm run build && cd src-tauri && \
  cargo build --release --no-default-features --features headless
# gates must pass under BOTH feature sets: default (gui) and
# --no-default-features --features headless
npm run check            # typecheck + Biome + ESLint — the frontend gate
npm test                 # frontend tests (Vitest, run mode)
npm run knip             # dead-code / dependency audit — a release gate

# Rust backend (run from src-tauri/)
cargo test               # backend tests
cargo fmt --check        # format check
cargo clippy --all-targets --all-features -- -D warnings   # lint, CI-strict

# Release
./scripts/release.sh <version>   # bump, commit, tag, push -> CI release

Run a single test:

npm test -- src/lib/foo.test.ts               # one frontend file
npx vitest run -t "resolves subagent"         # frontend, by test name
cd src-tauri && cargo test parent_backfills   # one Rust test by name substring
cd src-tauri && cargo test --test parser_tests# one Rust integration-test file

Real-data smoke tests (src-tauri/tests/*_real_*.rs) are #[ignore] by default; run them explicitly with cargo test -- --ignored. Git hooks (lefthook) pre-commit format staged frontend files and run ESLint; pre-push runs npm run check + npm test and the Rust fmt/clippy/test gate. CI and scripts/release.sh are the source of truth for exact commands.