Terminal tool to view and manage GitHub Copilot CLI sessions
Project description
🤖 Copilot Sessions
A rich terminal UI (TUI) to view and manage your GitHub Copilot CLI sessions — track usage, costs, premium requests, kill stale sessions, and clean up old ones.
Features
- Full TUI — interactive Textual-based terminal dashboard
- List & filter all Copilot CLI sessions with live search
- View details with full 💰 usage breakdown (tokens, models, premium requests, cost)
- Active sessions — see what's running live with
● LIVEindicators - Ghost detection — identify empty sessions (
👻 ghost: 0 B, 0 Msgs) - Kill stale/orphan live sessions (SIGTERM)
- Delete & cleanup old or ghost sessions in bulk
- Sort by clicking column headers (Status, Created, Size, etc.)
- Export sessions to CSV, JSON, or styled HTML report
- Statistics — total usage, premium reqs, disk, ghost count at a glance
- Resume command — copy-paste to jump back into any session
- About & Help screens built in (
i/?)
Installation
pipx (Recommended)
pipx install copilot-sessions
pip
pip install copilot-sessions
From source
git clone https://github.com/sk3pp3r/copilot-sessions.git
cd copilot-sessions
pipx install .
Usage
copilot-sessions # launch TUI dashboard
copilot-sessions --version # show version
copilot-sessions --help # CLI help + keyboard shortcuts
Keyboard Shortcuts
| Key | Action |
|---|---|
l |
List all sessions |
a |
Show active (live) sessions only |
f |
Toggle search / filter bar |
v / Enter |
View session detail + usage |
k |
Kill a live session |
d |
Delete an idle session |
c |
Cleanup ghost sessions (0 B, 0 Msgs) |
e |
Export (CSV / JSON / HTML) |
r |
Refresh session list |
? |
Help screen |
i |
About screen |
Escape |
Back |
q |
Quit |
Mouse: Click row to select · Click header to sort · Scroll wheel to navigate
Requirements
- Python 3.10+
- textual + rich (installed automatically)
- GitHub Copilot CLI (
~/.copilot/session-state/must exist)
License
MIT © Haim Cohen 2026
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file copilot_sessions-2.2.0.tar.gz.
File metadata
- Download URL: copilot_sessions-2.2.0.tar.gz
- Upload date:
- Size: 16.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
47d431e78eb405645b9ddbfbbc895115b1e13d603d67c91019196d9c481144e5
|
|
| MD5 |
1a092ad7f0849fe8606fd3de1e406d74
|
|
| BLAKE2b-256 |
30002bafac3b9c60af4cf15a9f063ab4b7d3e2ed9db8fe408cb2be68b9e7ebda
|
File details
Details for the file copilot_sessions-2.2.0-py3-none-any.whl.
File metadata
- Download URL: copilot_sessions-2.2.0-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c5cb35138f7ad21559231e035f3a0a11172fc05a8043077aea2e33db9d68d9a5
|
|
| MD5 |
62dcf45f09841501db188d24c3ef3895
|
|
| BLAKE2b-256 |
1126cefc55d2a3301eb94eb72d315c0f45706db15e666fe827635344616cfe75
|