Metadata-Version: 2.4
Name: claude-sessions
Version: 0.1.0
Summary: Monitor running Claude Code sessions in your terminal
Author: kyupid
License: MIT
Project-URL: Homepage, https://github.com/kyupid/claude-sessions
Project-URL: Repository, https://github.com/kyupid/claude-sessions
Project-URL: Issues, https://github.com/kyupid/claude-sessions/issues
Keywords: claude,claude-code,monitor,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: psutil>=5.9.0
Dynamic: license-file

# claude-sessions

Monitor all running Claude Code sessions in your terminal.

```
┌─────────────────────── Session Monitor (9 active) ───────────────────────┐
│                          Claude Code Sessions                            │
│ ┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━┓ │
│ ┃      PID ┃ Directory                    ┃  Terminal  ┃ Uptime ┃ Status┃ │
│ ┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━┩ │
│ │    31781 │ ~/git/my-project             │  ttys000   │  5d 3h │  Idle │ │
│ │    56351 │ ~                            │  ttys005   │ 1h 24m │  Idle │ │
│ │    61185 │ ~/git/another-project        │  ttys011   │    40m │  Idle │ │
│ └──────────┴──────────────────────────────┴────────────┴────────┴───────┘ │
│                    Updated: 18:45:32 | Press Ctrl+C to exit              │
└──────────────────────────────────────────────────────────────────────────┘
```

## Installation

```bash
pip install claude-sessions
```

## Usage

```bash
claude-sessions
```

That's it! The monitor updates every 3 seconds. Press `Ctrl+C` to exit.

## Features

- Real-time monitoring of all Claude Code CLI sessions
- Shows PID, working directory, terminal, uptime, and status
- Auto-refreshes every 3 seconds
- Clean TUI with [rich](https://github.com/Textualize/rich)

## Requirements

- Python 3.10+
- macOS or Linux
- Claude Code CLI installed

## License

MIT
