ephemeral-terminal-chat 0.1.0

Zero-trace terminal chat with 59s read-to-expire logic

Ephemeral Terminal Chat

Zero-trace terminal chat application with 59-second disappearing messages.

Features

• 🕒 Messages disappear after 59 seconds
• 🔒 Zero trace - no history kept
• 🚀 Fast terminal UI with Textual framework
• 🎨 JetBrains Mono font styling
• 🔗 Supabase backend for real-time sync
• 🏠 Share rooms with 6-character room codes
• 👤 Random nickname generation

Setup

1. Supabase Setup

1. Go to supabase.com and create a free account
2. Create a new project
3. Go to SQL Editor and run the supabase_setup.sql file
4. Get your project URL and anon key from Settings > API

2. Environment Variables

Copy .env.example to .env and add your Supabase credentials:

cp .env.example .env

Edit .env:

SUPABASE_URL=your_supabase_project_url
SUPABASE_KEY=your_supabase_anon_key

3. Install Dependencies

pip install -r requirements.txt

4. Run

python main.py

Usage

• Type message and press Enter to send
• Ctrl+R - Create new room
• Ctrl+C - Quit
• Share the Room ID with others to chat
• Messages auto-delete after 59 seconds

How It Works

• Each room has a unique 6-character ID
• Messages are stored in Supabase with timestamp
• Auto-cleanup deletes messages older than 59 seconds
• Terminal polls for new messages every second
• Zero-trace: no message history retained

Terminal Share

Share your terminal with:

• tmate: tmate
• warp: Share session feature
• ssh: Allow remote connections
• Or just share the Room ID via any channel