cont/CONTRIBUTING.md
2026-09-15 14:15:55 +01:00

1.1 KiB

Contributing

Keep changes focused. Open an issue before adding a major feature or dependency. Semantic search, dashboards, remote syncing and background services are outside the project's scope.

Checks

Requires Rust, a C compiler and Python 3 for the terminal tests.

cargo fmt --check
cargo clippy --locked --all-targets -- -D warnings
cargo test --locked
cargo build --release --locked
python3 tests/pty_smoke.py target/release/cont

Tests use fictional data. Terminal tests launch stub executables in place of real agents.

Bug reports and fixes

Include steps to reproduce and the relevant agent version. For parser bugs, provide a minimal fictional JSONL or SQLite fixture. Add a regression test with bug fixes where practical.

Do not commit real session histories, caches, credentials or screenshots of private work.

Code structure

  • src/parse.rs: Pi, Claude Code, Codex and OMP JSONL parsing.
  • src/opencode.rs: OpenCode SQLite reader.
  • src/index.rs: session discovery and caching.
  • src/search.rs: title and human-message search.
  • src/session.rs: session metadata and agent launch commands.
  • src/ui.rs: terminal UI.