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.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.