About this project

`cs` (Copilot Sessions) is a terminal application that provides a full interface over the session store of GitHub Copilot CLI. It allows users to browse, search, read, audit, and resume past sessions without leaving the shell. The tool is read-only, makes no network calls, and has zero runtime dependencies beyond Python 3.10+. Key features include: - **Home screen** with arrow-key navigation, live filtering, and access to all views. - **Session browsing** grouped by day, repository, or full-text search across turns and checkpoints. - **Session inspection** with `cs show` summarizing key details (open items, first request, shipped commits/PRs) and `cs read` for paged conversation viewing. - **Resume sessions** with `cs resume #N` to jump back into a session. - **Skills and agents analysis** showing which are used versus installed, with per-repo breakdowns. - **Instructions audit** flagging files over Copilot's 4,000-character truncation limit. - **Stats and cost tracking** including commits, PRs, files, AI spend by model/repo/day, cache efficiency, and delegation splits. - **Security audit** scanning for credentials in session text, with masked evidence and severity levels, plus detection of destructive actions (file deletions, DB drops). - **Autonomy and handoff views** for unattended sessions and work passed between sessions. - **Reference views** for skills, agents, instructions, hooks, and MCP servers. All views support `--json`, `--csv`, and `--why` flags for scriptable output and evidence-based reasoning. The tool is designed with privacy in mind: the SQLite store is opened read-only, no network code exists, credentials are masked at render time, and terminal escape sequences are stripped. Installation is available via Homebrew (recommended) or from source with `pip install .`. The project includes comprehensive documentation, tests, and a security threat model.