The Shellit Chronicle
Honest devlog from empty directory to production: multi-agent orchestration, hardware crashes, zero-knowledge sync, and the epic battle of Qwen vs Antigravity.
All Acts & Milestones
Explore thematic chapters tracking the evolution of Shellit from architectural blueprint to audited release and web chronicle.
Act I: Ground Zero & Architectural Manifesto
From empty folder to 105 green tests in two hours: why we dropped TermIt, how /grill-me prevented monolithic spaghetti, and how 4 AI subagents worked in parallel.
Act II: Hardware Detective & Console Awakening
Migration to xterm 4, unexpected Kernel-Power 41 crashes during C++ compilation, and the birth of Safe Build Protocol. First integration bugs: silent terminals and frozen cursors.
Act III: Sysadmin Powerhouse — SFTP, Splits & Flight Recorder
Dual-pane SFTP with octal 0755 permissions, automated OS icon detection, zero-latency asciinema session recording, 2x2 matrix tiling with broadcast input, and brand logo.
Act IV: Zero-Knowledge — Self-Hosted E2EE & Android Renaissance
Rejecting proprietary clouds: building a self-hosted Zero-Knowledge E2EE relay for VPS, honest Argon2id master-password rotation, IndexedStack GlobalKey traps, and Android touch bar.
Act V: Gateway to the Future — MCP Server, Gemini & ConPTY
Shellit learns to converse with AI: Model Context Protocol (MCP) integration for Cursor and Claude, Google Gemini BYOK snippet generation, and native Windows ConPTY local shells.
Act VI: Orbital Deployment — Web Portal, PocketBase & Cloudflare Tunnel
Astro and Starlight portal creation, cyberpunk /admin dashboard with Chart.js, vote abuse prevention via pb_hooks, and global rollout to shellit.top via Cloudflare Tunnel.
Act VII: Battle of the Titans — Qwen vs Antigravity & v0.8.5 Triumph
The vibe-coding climax: when tests shine green but instincts demand verification. How Qwen executed a ruthless Red Team audit, exposed MitM vulnerabilities, and how we rebuilt the core on Fail-Closed and OpenSSH Randomart.
Act VIII: The Birth of the Web Chronicle — Emerging from Repository Shadows & The Devlog in the Mirror
The strategic decision: why Shellit brought its engineering devlog into the open and established a public chronicle on its website. Stepping out from Git folders, the Knuth-Plass algorithm, authentic dialogue spoilers, and responsive TOC.
Act IX: Armor for Production Servers — Universal Command Guard & v0.8.6 Release
A deep audit of remote server protection: why the Production Guard toggle failed on default hosts, how Bash history bypassed keystroke interception via Up Arrow, xterm screen buffer inspection, protecting nano/vim editors, and the v0.8.6 release.
Act X: Socket Pool Salvation — 16,000 Leaked Ports, the OpenSSH Banner, and v0.8.8 Release
The story of an unexpected network blackout: how background RTT telemetry in shellit.exe exhausted 16,071 Windows ports due to the subtle difference between socket.close() and socket.destroy(), how OpenSSH banners trap half-closed sockets, SQLite telemetry decoupling, and the v0.8.8 release.
Act XI: The Mystery of the Swallowed Character — How Layout Switching Ate Keystrokes & How We Taught the Terminal to Listen
An engineering post-mortem on the missing first character after switching keyboard languages (Alt+Shift, Ctrl+Shift, Win+Space): how Win32 SC_KEYMENU intercepted inputs, why Flutter retained ghost modifiers in HardwareKeyboard, prioritizing printable glyphs, and restoring instant terminal response.
Act XII: The Living Terminal Canvas — How Command Markers Transformed an Endless Log into an Interactive Map, and Paying Tribute to Open Source Roots
The story behind OSC 133 semantic terminal integration in Shellit: colored exit status badges, execution timing, 1-click output copy, sequential Alt+Up/Down navigation, user-controlled opt-in activation without background injections, and honest attribution to Fabrizio La Rosa (fbrzlarosa/terminale) and the uxiew fork.
Act XIII: Mobile Resilience & Cryptographic Hygiene — Resolving Post-Sync Key Decryption & Streamlining Android UX
Post-mortem analysis of BUG-051: why vault synchronization stumbled upon empty private keys, how continuous socket pings triggered Fail2ban, why desktop AI settings were pruned on mobile, and how terminal touch ergonomics were refined.
Act XIV: The Google AI Studio Audit & Rendering Pipeline Triumph — How Gemini 3.8 Flash Uncovered Hidden Flutter Bottlenecks & We Conquered Buffer Eviction
How a comprehensive repository audit with Gemini 3.8 Flash in Google AI Studio revealed critical Flutter terminal rendering bottlenecks, how three parallel subagents resolved BUG-052..BUG-054, and how real-world stress testing solved OSC 133 command marker scrollback eviction.
Act XV: First Field Crash-Test on Arch Linux — Fixing Omni-Search Split Tiling Freeze on Wayland & Integrating GitHub MCP
How the first public GitHub Issue #1 from an Arch Linux power user exposed an OpenGL/Wayland frame timeout during rapid Ctrl+K split layout switching, how GitHub MCP integration enabled real-time AI issue diagnosis, and how we streamlined Linux shell detection.
Act XVI: Console Aesthetics for Linux Power Users — Custom Typography, Nerd Fonts Cascade, and Kitty Graphics Architecture
How we implemented configurable terminal fonts with a resilient Nerd Fonts fallback stack (U+E000..U+F8FF), engineered a streaming APC filter for Kitty Graphics Protocol image rendering in yazi, and safeguarded the isolated cursor overlay from layer conflicts.
Building in public with 100% open source transparency.