Metadata-Version: 2.4
Name: chatpulse-cli
Version: 0.1.2
Summary: Terminal-based CLI client for ChatPulse real-time chat
License: MIT
Project-URL: Homepage, https://chatpulse.online
Project-URL: Source, https://github.com/shiv-am0/chat-pulse
Project-URL: Tracker, https://github.com/shiv-am0/chat-pulse/issues
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer<1,>=0.12
Requires-Dist: rich<14,>=13
Requires-Dist: httpx<1,>=0.27

# ChatPulse CLI

Terminal-based client for [ChatPulse](https://chatpulse.online) — a real-time messaging platform powered by Kafka.

## Install

**macOS / Linux** (auto-installs pipx if missing, no system-package or PATH fiddling):

```bash
curl -sSL https://chatpulse.online/install.sh | bash
```

**Windows** (PowerShell — auto-installs pipx if missing):

```powershell
powershell -ExecutionPolicy Bypass -c "irm https://chatpulse.online/install.ps1 | iex"
```

**Any OS** (pipx required — see [Prerequisites](#prerequisites)):

```bash
pipx install chatpulse-cli
```

The CLI installs into an isolated pipx environment, so it never touches your system Python.

## Quick Start

```bash
# Register a new account
chatpulse auth register username your@email.com

# Login
chatpulse auth login username

# List rooms
chatpulse rooms list

# Start chatting in room 1
chatpulse chat 1
```

## Features

- JWT-based authentication
- Room creation, listing, joining, leaving
- Real-time message sending and polling
- Interactive chat mode
- Persistent config across sessions

## Requirements

Python 3.10+

## Prerequisites

- **Python 3.10+** — install from <https://python.org/downloads> if missing.
- **pipx** — the install scripts bootstrap it automatically (via your package manager, or into an isolated fallback environment; they never use `--break-system-packages`). To install it yourself: `brew install pipx` (macOS), `sudo apt install pipx` (Debian/Ubuntu), or `python3 -m pip install --user pipx`.
- **Windows** — interactive `chatpulse chat` requires [WSL](https://learn.microsoft.com/windows/wsl/install); all other commands run natively in PowerShell.
