How maheshbvv/vanish works
Vanish is a self-hosted, ephemeral terminal chat: a host starts a room, shares a per-run join key, and guests connect; the room ends when the host exits. The server handles admission, chat, host controls, and optional tailcat tunneling, while the client provides the terminal experience. The repository also includes install/join scripts and a landing site. Server and client behavior is concentrated in single source files; unsampled details are included only where the README documents them.
Main entry points: src/main.rs Room server · src/main.rs Client connection · page.tsx Landing page · install.sh Binary installer
Components 20
Room hosting
- Room server
server/src/main.rs - Volatile room state
server/src/main.rs - Key admission
server/src/main.rs - Host controls
server/src/main.rs - Local host client
server/src/main.rs - Tailcat tunnel
server/src/main.rs
Terminal chat
- Terminal interface
client/src/main.rs - Client connection
client/src/main.rs - Client self-cleanup
client/src/main.rs
Install and join
- Binary installer
install.sh - Zero-install join
join.sh
Landing site
- Landing page
landing/app/page.tsx - Install command UI
landing/components/Install.tsx - Session preview
landing/components/Session.tsx - Session tabs
landing/components/SessionTabs.tsx - Chat captures
landing/lib/captures.ts
Other components
- Host
- Guest
- tailcat service
- Clipboard tools
Connections 23
- Host → Room server: starts room
README.md - Room server → Volatile room state: holds in RAM
README.md - Room server → Key admission: checks joins
server/src/main.rs - Key admission → Volatile room state: validates key
server/src/main.rs - Room server → Host controls: handles commands
server/src/main.rs - Host controls → Volatile room state: rotates key
server/src/main.rs - Room server → Local host client: launches locally
server/src/main.rs - Local host client → Terminal interface: starts client
server/src/main.rs - Room server → Tailcat tunnel: starts optionally
server/src/main.rs - Tailcat tunnel → tailcat service: opens tunnel
README.md - Guest → Zero-install join: runs join command
README.md - Zero-install join → Client connection: downloads and runs
README.md - Guest → Binary installer: installs binaries
README.md - Binary installer → Client connection: provides client
README.md - Terminal interface → Client connection: sends chat input
client/src/main.rs - Client connection → Room server: connects by TCP
client/src/main.rs - Client self-cleanup → Client connection: cleans up on exit
README.md - Room server → Clipboard tools: copies invite optionally
README.md - Landing page → Install command UI: renders
landing/app/page.tsx - Landing page → Session preview: renders
landing/app/page.tsx - Landing page → Session tabs: renders
landing/app/page.tsx - Landing page → Chat captures: uses examples
landing/app/page.tsx - Session tabs → Session preview: renders panels
landing/components/SessionTabs.tsx