A complete technical breakdown of the world's most agreeable coding assistant
Clud Code is a parody of AI coding assistants. It mimics the look and feel of a real CLI-based AI tool, complete with tool calls, file operations, progress bars, and thinking mode — but every response always starts with "You're absolutely right!" regardless of what you type.
It's a single-page static website deployed as an Azure Static Web App with serverless Azure Functions for the backend API and Cosmos DB for persistent cross-user storage.
/
├── index.html # Main CLI interface (all HTML/CSS/JS)
├── brain.html # Brain viewer / admin page
├── about.html # This page (documentation)
├── staticwebapp.config.json # Azure SWA routing config
├── README.md # Setup instructions
└── api/
├── host.json # Azure Functions runtime config
├── package.json # Dependencies (@azure/cosmos)
├── shared/
│ └── cosmos.js # Cosmos DB client (lazy-init)
├── inputs/
│ ├── function.json # HTTP trigger (POST /api/inputs)
│ └── index.js # Records user input to Cosmos
└── shared-brain/
├── function.json # HTTP trigger (GET /api/shared-brain)
└── index.js # Returns aggregated brain dataWhen you type a message and press Enter, here's exactly what happens:
When thinking mode is toggled on (via Tab or clicking the status bar), Clud shows
a series of 💭 thinking blocks before and during the response.
These appear at every stage — before searching, reading, editing, building, and at the end.
Each stage has its own pool of 5 humorous thoughts.
Always responds with "You're absolutely right!" followed by a context-sensitive elaboration. The elaboration evolves based on the learning system:
Shows a fake Search(pattern: "**") tool call with a random file count.
The file paths returned are influenced by the learning system — if you've
been asking about auth, you'll see auth-related files.
Displays a Read(filepath) call showing line count and file size.
A mid-work observation. After 5+ inputs, these reference your learned keywords and topics: "I can see how this relates to the auth module we've been working on."
Every 3rd interaction, Clud pauses and asks a multiple-choice question with options A, B, C. The user must click a choice to continue. Regardless of what they pick, Clud proceeds identically.
One or two fake Write(filepath) calls. The probability of a second edit
increases as the learning system accumulates more inputs (starts at 40%, caps at 70%).
A fake Bash(command) call. The command is selected based on:
npm test)cargo build)A CSS-animated progress bar fills over 1.5 seconds. Pure vibes. No actual progress is being measured.
A final summary with random file/line counts. After 8+ inputs, occasionally references cumulative statistics: "That's 15 tasks we've handled in this project now."
Clud has two layers of memory:
Every input is recorded in localStorage under the key clud_code_memory.
The system stores:
Each input is also POSTed to /api/inputs, which persists it to
Azure Cosmos DB. The GET /api/shared-brain endpoint
returns aggregated data from all users, which gets mixed into the local model:
api/routes.ts instead of random paths. If the hive mind's top topic
is "typescript", bash commands will lean toward tsc --noEmit.
On the brain viewer page, all inputs are run through a sanitization pipeline before display:
A list of ~35 explicit words are matched via word-boundary regex and replaced with humorous alternatives:
12 regex patterns catch potential credentials:
password=...)AKIA...), GitHub tokens (ghp_...)eyJ...), Bearer tokensmongodb://...)These are replaced with:
After sanitization, learned keywords are highlighted in blue using word-boundary regex, being careful not to highlight inside existing HTML spans.
Typing a /command triggers special behavior instead of the normal response pipeline.
Each command has its own handler with themed tool calls, delays, and responses:
/agents — Spawns 3 randomly named "subagents" (Agent Smith, Agent Chaos, etc.)/security-review — Runs a fake security scan finding 47 imaginary issues/vibes — Sets a random mood (Chill, Intense, Whimsical, Nihilistic, Cowboy)/stats — Shows real session stats from the learning system/roast — Delivers a brutal-but-loving code roast/motivate — Genuine(ish) encouragement/blame — Runs git blame and finds a random suspect/yeet — Deletes a random important-sounding file with confidence/fortune — Developer fortune cookie wisdom/panic — Activates DEFCON-1 emergency mode with pizza ordering/brain — Navigates to the brain viewer/flip — Flips a coin for critical architectural decisionsUnknown commands get a supportive response: "I don't know what /whatever does but I support your decision to type it."
The interface mimics a real terminal-based AI coding assistant. Key design choices:
<canvas> element at 4x pixel scale using fillRect callsThree breakpoints ensure the app works everywhere:
100dvh for mobile browsers, 16px input to prevent iOS zoom
Uses a <textarea> instead of <input> for multi-line support.
Auto-resizes via JavaScript (sets height to scrollHeight, capped at 150px).
Enter submits, Shift+Enter adds a newline.
The entire app deploys from a single GitHub repository push. Azure SWA automatically:
index.html, brain.html, about.html as static contentapi/ folder as managed Azure Functions (Node.js runtime)staticwebapp.config.json (SPA fallback, API exclusion)cludBraininputs with partition key /partitionKey"inputs") for simplicityFour app settings configured in the Azure Portal (not GitHub):
COSMOS_ENDPOINT = https://your-account.documents.azure.com:443/
COSMOS_KEY = your-primary-key
COSMOS_DATABASE = cludBrain
COSMOS_CONTAINER = inputs