Metadata-Version: 2.4
Name: copilot-sessions
Version: 1.3.0
Summary: Terminal tool to view and manage GitHub Copilot CLI sessions
Author: Haim Cohen
License: MIT
Project-URL: Homepage, https://github.com/sk3pp3r/copilot-sessions
Project-URL: Issues, https://github.com/sk3pp3r/copilot-sessions/issues
Keywords: copilot,github,cli,sessions
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Dynamic: license-file

# 🤖 Copilot Sessions

A terminal tool to view and manage your GitHub Copilot CLI sessions — track usage, costs, premium requests, kill stale sessions, and clean up old ones.

![Python](https://img.shields.io/badge/python-3.9+-blue)
![License](https://img.shields.io/badge/license-MIT-green)

## Features

- **List & filter** all Copilot CLI sessions
- **View details** with full 💰 usage breakdown (tokens, models, premium requests, cost)
- **Active sessions** — see what's running live
- **Kill** stale/orphan live sessions
- **Delete & cleanup** old sessions by age
- **Statistics** — total usage across all sessions
- **Resume command** — copy-paste to jump back into any session

## Installation

### pipx (Recommended)
```bash
pipx install copilot-sessions
```

### pip
```bash
pip install copilot-sessions
```

### From source
```bash
git clone https://github.com/sk3pp3r/copilot-sessions.git
cd copilot-sessions
pipx install .
```

## Usage

```bash
copilot-sessions              # launch interactive manager
copilot-sessions --active     # show active sessions only
copilot-sessions --version    # show version
copilot-sessions --help       # full help
```

### Interactive Commands

| Key | Action |
|-----|--------|
| `l` | List all sessions |
| `f` | Filter/search sessions |
| `a` | Active sessions |
| `v` | View session detail + 💰 Usage |
| `s` | Show statistics |
| `d` | Delete session(s) |
| `k` | Kill live session(s) |
| `c` | Cleanup old sessions |
| `r` | Refresh |
| `q` | Quit |

## Requirements

- Python 3.9+
- [rich](https://github.com/Textualize/rich) (installed automatically)
- GitHub Copilot CLI (`~/.copilot/session-state/` must exist)

## License

MIT © Haim Cohen
