Phosphor

phosphor

> Discord UX + IRC Protocol = Terminal Magic

A resurrection of IRC with Discord's user experience, running in a high-performance Terminal UI. Proves that modern collaboration doesn't need 2GB of RAM—it just needs better design.

🚀 Quick Start

# Setup (one time)
./setup.sh

# Run
python -m src.main

# Try it
# - Chat in real IRC channels (#python, #linux, #programming)
# - See live member lists in the sidebar
# - Press F1 for Teletext dashboard
# - Type /ai docker-stats
# - Type /send demo.txt

✨ Features

🎨 Discord-Like Interface

Beautiful 3-pane layout with channels, chat, and members. Markdown support, syntax highlighting, and rich embeds.

📺 Teletext Dashboard (F1) - Page 100

Authentic 1980s Ceefax/Oracle aesthetic with modern DevOps data. Features:

• Ticking clock (seconds update in real-time)
• ASCII CPU/Memory graphs using psutil
• Container status matrix with colored blocks
• Git commits as "Breaking News" headlines
• Scrolling ticker tape with error logs
• Strict 8-color palette (Black, White, Red, Green, Blue, Cyan, Magenta, Yellow)
• Block graphics (█ ▀ ▄ ░) for authentic retro feel

🔐 Wormhole File Transfer

Peer-to-peer encrypted file transfers with human-readable codes. No cloud, no traces, just magic.

🔊 Geiger Counter Audio

Audio feedback for system health. Hear errors before you see them. Escalating sounds for increasing error rates.

🤖 MCP Integration

AI-powered commands via Model Context Protocol. Extensible tool system for automation.

📊 Performance

| Metric | Discord | phosphor | |--------|---------|----------| | Memory | 2GB | 20MB | | Startup | 10s | | Send file via wormhole | | /grab | Receive file via wormhole | | /ai [query]` | DevOps Health Bot - Check Docker containers |

🤖 DevOps Health Bot

phosphor includes an AI-powered DevOps assistant that automatically monitors Docker container health:

# In the TUI or via IRC:
/ai                    # Check all containers
/ai prod               # Check production
/ai staging web        # Check staging web service

Features:

• 🏥 Automatic health assessment (healthy, warning, critical)
• 🔍 Smart filtering by environment (prod, staging) and service (web, api, db)
• 📊 Monitors status, health checks, restarts, CPU, memory
• 💬 IRC-friendly output with emojis and actionable recommendations
• 🔒 Read-only, safe operations

🛠️ Tech Stack

• Python 3.11+ - Language
• Textual - Modern TUI framework
• bottom - Async IRC library
• magic-wormhole - P2P file transfers
• simpleaudio - Audio feedback
• plotext - ASCII charts
• MCP - AI integration with Docker monitoring

📁 Project Structure

phosphor/
├── src/
│   ├── core/          # Backend (IRC, MCP, Wormhole, Audio)
│   └── ui/            # Frontend (Textual TUI)
├── assets/
│   ├── screenshots/   # UI screenshots
│   └── logo.txt       # ASCII logo
├── setup.sh           # One-time setup script
└── ARCHITECTURE.md    # Technical deep dive

🏆 Why phosphor?

• Efficient: 1/100th the memory of Discord
• Fast: Sub-second startup, zero-latency UI
• Open: Built on IRC, the original open protocol
• Innovative: Only chat app with audio feedback
• Beautiful: Discord's UX in your terminal
• Practical: Actually solves real problems

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: crypticsaiyan
• Source: crypticsaiyan/phosphor
• License: MIT

Install and usage instructions live in the source repository linked above.