shit_admin: 2026-08-13 12:41:21

2026-08-13 12:41:21 -04:00
parent f369d56026
commit ca7081dd92
162 changed files with 7552 additions and 4 deletions
@@ -0,0 +1,527 @@
+# 🔗 AI Handoff — Projects & Agent Workspace
+
+**Live at:** [https://app.ai-handoff.work](https://app.ai-handoff.work)  
+**Repo:** [https://github.com/stateofshit/url-shortener](https://github.com/stateofshit/url-shortener)  
+**Built:** August 12, 2026
+
+* * *
+
+## What This Covers
+
+### 1. URL Shortener (Production App)
+A **production-ready URL shortener** with **live click analytics**, deployed entirely on **Cloudflare's edge infrastructure**. No accounts, no databases to manage, no servers to maintain. Just paste a long URL, get a short one, and watch the clicks roll in.
+
+📄 See below for full URL Shortener documentation.
+
+### 2. Assistant Workspace (Agent Project)
+An **AI agent starter** built with Cloudflare Agents SDK + TypeScript, living at:
+
+```
+/home/user/03-projects/assistant-workspace/
+```
+
+Copied from `.agents/skills/agents-sdk/my-agent/`. Purpose-built for autonomous agent behavior using the Cloudflare Workers platform.
+
+#### Quick Start
+```bash
+cd /home/user/03-projects/assistant-workspace
+npx wrangler dev    # local dev
+npx wrangler deploy  # production
+```
+
+#### Structure
+```
+assistant-workspace/
+├── AGENTS.md       # Agent guidelines & docs
+├── src/            # Agent source code
+├── test/           # Vitest tests
+├── wrangler.jsonc  # Worker bindings config
+└── package.json    # Agents SDK deps
+```
+
+* * *
+
+## 🏗️ Architecture Overview (URL Shortener)
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         YOUR BROWSER                            │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                    Cloudflare DNS (ai-handoff.work)             │
+│  shit.ai-handoff.work  →  Worker API                           │
+│  dash.ai-handoff.work  →  Dashboard (Pages)                    │
+│  app.ai-handoff.work   →  React App (Pages)                    │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│              Cloudflare Workers + Pages + D1                    │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  Worker: url-shortener-api (shit.ai-handoff.work)      │   │
+│  │  - POST /api/shorten                                    │   │
+│  │  - GET  /api/links                                      │   │
+│  │  - GET  /api/trends/:code                               │   │
+│  │  - GET  /{code}  → 301 redirect to original URL         │   │
+│  └─────────────────────────────────────────────────────────┘   │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  Pages: shrtlink (dash.ai-handoff.work)                 │   │
+│  │  - Static HTML/CSS/JS dashboard with live stats         │   │
+│  │  - Copy-link button, 14-day sparkline trends            │   │
+│  └─────────────────────────────────────────────────────────┘   │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  Pages: shrtlink-app (app.ai-handoff.work)              │   │
+│  │  - React Vite app (same functionality, different UI)    │   │
+│  │  - Built with React 19 + Vite 6                         │   │
+│  └─────────────────────────────────────────────────────────┘   │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  D1 Database: url-shortener-db                          │   │
+│  │  - urls table: code, url, clicks, created_at            │   │
+│  │  - clicks table: code, clicked_at (per-click history)   │   │
+│  └─────────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+* * *
+
+## 🛠️ Tech Stack (URL Shortener)
+
+| Layer | Technology | Purpose |
+| --- | --- | --- |
+| **Edge Runtime** | Cloudflare Workers | URL shortening, redirects, API endpoints |
+| **Static Sites** | Cloudflare Pages | Dashboard + React app deployment |
+| **Database** | Cloudflare D1 (SQLite) | Store URLs, click counts, click timestamps |
+| **Frontend (Dashboard)** | Vanilla HTML/CSS/JS | Lightweight, fast, no build step |
+| **Frontend (React App)** | React 19 + Vite 6 | Modern SPA with same features |
+| **CI/CD** | GitHub Actions | Auto-deploy on `git push master` |
+| **Custom Domains** | Cloudflare DNS | `*.ai-handoff.work` |
+
+**Agent Workspace uses:** Cloudflare Workers + Agents SDK + TypeScript + Vitest
+
+* * *
+
+## 🌐 Custom Domains (URL Shortener)
+
+All domains point to Cloudflare infrastructure and are **proxied** (CDN + security enabled):
+| Domain | Target | Status |
+| --- | --- | --- |
+| `shit.ai-handoff.work` | Worker API | ✅ Live (200) |
+| `dash.ai-handoff.work` | Dashboard (Pages `shrtlink`) | ✅ Live (200) |
+| `app.ai-handoff.work` | React App (Pages `shrtlink-app`) | ✅ Live (200) |
+
+**Why custom domains?**
+
+*   Professional URLs (not `workers.dev` or `pages.dev`)
+*   SSL certificates auto-provisioned by Cloudflare
+*   CDN caching at the edge
+*   DDoS protection via Cloudflare
+
+* * *
+
+## ✨ Features (URL Shortener)
+
+### 1. URL Shortening
+*   Paste any `http://` or `https://` URL
+*   Get a 6-character short code (e.g., `f5RHkl`)
+*   Short URL: `https://shit.ai-handoff.work/f5RHkl`
+*   **Strict validation**: rejects `javascript:`, `ftp://`, etc.
+*   **Dedupe**: shortening the same URL twice returns the existing code
+
+### 2. Live Dashboard
+*   **Total links count** (real-time from D1)
+*   **Total clicks count** (sum of all link clicks)
+*   **Table of all links** with:
+  *   Short URL (clickable)
+  *   Destination URL (truncated if >60 chars)
+  *   Click count (badge)
+  *   14-day trend sparkline (SVG bar chart)
+  *   Creation date
+  *   Copy button (⎘ → ✓ with clipboard API)
+*   **Auto-refresh** every 15 seconds
+
+### 3. Click Analytics
+*   **Per-click tracking**: every redirect logs a timestamp to `clicks` table
+*   **Daily buckets**: `/api/trends/:code` returns `{day, n}` for last 14 days
+*   **Sparkline visualization**: inline SVG bar chart per link
+*   **Zero data loss**: historical clicks preserved even if URL is deleted
+
+### 4. Developer Experience
+*   **Auto-deploy**: push to `master` → GitHub Actions → Cloudflare
+*   **Local dev**: `npm run dev` (Vite) + `wrangler dev` (Worker)
+*   **Type-safe**: D1 queries via Wrangler bindings
+*   **Testable**: Playwright E2E tests in `/tmp/*.mjs`
+
+* * *
+
+## 📁 Project Structure (URL Shortener)
+
+```
+url-shortener/
+├── .github/workflows/
+│   └── deploy.yml              # GitHub Actions CI/CD
+├── .wrangler/                  # Wrangler cache (gitignored)
+├── dashboard/                  # Static dashboard (HTML/CSS/JS)
+│   ├── index.html
+│   ├── app.js                  # Dashboard logic
+│   └── styles.css              # Dark theme styles
+├── dist/                       # Vite build output (gitignored)
+├── src/                        # React app source (Vite)
+│   ├── main.jsx
+│   └── App.jsx
+├── wrangler-api/               # Worker + D1 migrations
+│   ├── src/
+│   │   └── index.js            # Worker fetch handler
+│   ├── migrations/
+│   │   ├── 000_create_urls.sql
+│   │   ├── 001_add_clicks.sql
+│   │   └── 002_create_clicks.sql
+│   ├── wrangler.jsonc          # Worker config + D1 binding
+│   └── package.json
+├── .env                        # Cloudflare credentials (gitignored)
+├── .env.example                # Example env vars
+├── .gitignore
+├── index.html                  # Root (redirects to dashboard)
+├── package.json                # Vite + React deps
+└── vite.config.js
+```
+
+* * *
+
+## 🗄️ Database Schema (URL Shortener - D1)
+
+### `urls` table
+
+```sql
+CREATE TABLE urls (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  code TEXT NOT NULL UNIQUE,           -- 6-char short code
+  url TEXT NOT NULL,                   -- original URL
+  clicks INTEGER NOT NULL DEFAULT 0,   -- running total
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+### `clicks` table (migration 002)
+
+```sql
+CREATE TABLE clicks (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  code TEXT NOT NULL,
+  clicked_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (code) REFERENCES urls(code)
+);
+CREATE INDEX idx_clicks_code ON clicks(code, clicked_at);
+```
+
+**Why two tables?**
+
+*   `urls.clicks` = fast counter for the dashboard badge
+*   `clicks` table = per-click history for trend charts
+
+* * *
+
+## 🔌 API Endpoints (URL Shortener)
+
+All endpoints on `https://shit.ai-handoff.work`:
+
+### `POST /api/shorten`
+
+**Request:**
+
+```json
+{ "url": "https://example.com/very/long/path" }
+```
+
+**Response (200):**
+
+```json
+{
+  "shortUrl": "https://shit.ai-handoff.work/f5RHkl",
+  "code": "f5RHkl",
+  "dedupe": false
+}
+```
+
+**Errors:**
+*   `400` — invalid URL, missing `url` field
+*   `500` — internal error
+
+### `GET /api/links`
+
+**Response (200):**
+
+```json
+{
+  "links": [
+    {
+      "code": "f5RHkl",
+      "url": "https://example.com/long/path",
+      "clicks": 42,
+      "created_at": "2026-08-12T03:00:00Z"
+    }
+  ]
+}
+```
+
+### `GET /api/trends/:code`
+
+**Response (200):**
+
+```json
+{
+  "code": "f5RHkl",
+  "daily": [
+    { "day": "2026-08-11", "n": 3 },
+    { "day": "2026-08-12", "n": 4 }
+  ]
+}
+```
+
+### `GET /{code}` (redirect)
+
+**Behavior:**
+*   301 Moved Permanently → original URL
+*   Increments `urls.clicks` + logs to `clicks` table
+*   CORS headers for cross-origin requests
+
+* * *
+
+## 🚀 Deployment
+
+### Manual Deploy (URL Shortener)
+
+```bash
+# Worker
+cd wrangler-api && npx wrangler deploy
+
+# Dashboard (Pages)
+cd dashboard && npx wrangler pages deploy ./ --project-name=shrtlink
+
+# React app (Pages)
+npx wrangler pages deploy ./dist --project-name=shrtlink-app
+```
+
+### Auto-Deploy (GitHub Actions)
+
+```yaml
+# Triggered on: git push origin master
+# Steps:
+# 1. Build Vite app (npm run build)
+# 2. Deploy Worker (npx wrangler deploy)
+# 3. Deploy Dashboard (npx wrangler pages deploy)
+# 4. Deploy React app (npx wrangler pages deploy)
+```
+
+**Secrets required:**
+*   `CLOUDFLARE_API_TOKEN` — Cloudflare API token with Pages + Workers permissions
+*   `CLOUDFLARE_ACCOUNT_ID` — Cloudflare account ID
+
+### Agent Workspace Deploy
+
+```bash
+cd /home/user/03-projects/assistant-workspace
+npx wrangler deploy
+```
+
+* * *
+
+## 🧪 Testing (URL Shortener)
+
+### Local Development
+
+```bash
+# Terminal 1: Worker (localhost:8787)
+cd wrangler-api && npx wrangler dev
+
+# Terminal 2: Vite dev server (localhost:5173)
+npm run dev
+
+# Terminal 3: Dashboard (localhost:3000)
+cd dashboard && npx wrangler pages dev ./
+```
+
+### E2E Tests (Playwright)
+
+```bash
+# Test dashboard features
+node /tmp/dash-features.mjs
+
+# Test copy button + trends
+node /tmp/copy-test.mjs
+
+# Full end-to-end
+node /tmp/custom-e2e.mjs
+```
+
+### Agent Workspace Tests
+
+```bash
+cd /home/user/03-projects/assistant-workspace
+npx vitest
+```
+
+* * *
+
+## 🔒 Security (URL Shortener)
+
+*   **Strict URL validation**: only `http:` and `https:` protocols allowed
+*   **CORS**: `Access-Control-Allow-Origin: *` (public API)
+*   **Dedupe**: prevents duplicate rows for same URL
+*   **Collision check**: 6-char codes from 62^6 = ~56B combinations
+*   **SSL**: auto-provisioned by Cloudflare for all custom domains
+*   **DDoS protection**: Cloudflare edge network
+
+* * *
+
+## 📊 Live Stats (URL Shortener — as of Aug 12, 2026)
+
+| Metric | Value |
+| --- | --- |
+| Total links | 11 |
+| Total clicks | 8 |
+| Active domains | 3 |
+| Deployments | 42s avg |
+| Uptime | 100% |
+
+* * *
+
+## 🎯 How to Use
+
+### As a User (URL Shortener)
+1.  Go to [**https://app.ai-handoff.work**](https://app.ai-handoff.work) or [**https://dash.ai-handoff.work**](https://dash.ai-handoff.work)
+2.  Paste a long URL into the input field
+3.  Click **Shorten**
+4.  Copy the short URL (⎘ button) or click to open it
+5.  Share it — when people click it, you'll see the click count increase in real-time
+
+### As a Developer (URL Shortener)
+1.  Clone the repo: `git clone https://github.com/stateofshit/url-shortener`
+2.  Set up Cloudflare credentials in `.env` (see `.env.example`)
+3.  Run locally: `npm run dev` + `cd wrangler-api && npx wrangler dev`
+4.  Deploy: `git push origin master` (auto-deploys via GitHub Actions)
+
+### As a Developer (Agent Workspace)
+1.  Workspace lives at: `/home/user/03-projects/assistant-workspace/`
+2.  Source synced from: `.agents/skills/agents-sdk/my-agent/`
+3.  Run locally: `cd assistant-workspace && npx wrangler dev`
+4.  Deploy: `cd assistant-workspace && npx wrangler deploy`
+
+* * *
+
+## Key Design Decisions (URL Shortener)
+
+### Why Cloudflare?
+*   **Edge runtime**: Workers execute at the edge (closest to user)
+*   **Free tier**: 100K requests/day on Workers, 10K on D1
+*   **Zero config**: No servers, no scaling, no DevOps
+*   **Built-in SSL**: Automatic HTTPS for custom domains
+
+### Why D1 (SQLite) instead of KV?
+*   **SQL queries**: need `GROUP BY`, `ORDER BY`, `JOIN` for analytics
+*   **Relational**: `clicks` table references `urls` table
+*   **Cost**: D1 is cheaper than Vectorize for this use case
+
+### Why two frontends?
+*   **Dashboard** (vanilla): lightweight, fast, no build step
+*   **React app** (Vite): modern SPA, same features, different UI
+*   **Proof of concept**: shows both approaches work on Cloudflare
+
+### Why 6-character codes?
+*   **Short**: `f5RHkl` is memorable
+*   **Collision-resistant**: 62^6 = 56 billion combinations
+*   **URL-friendly**: no special characters, no encoding needed
+
+* * *
+
+## 🚧 Known Limitations (URL Shortener)
+
+1.  **No user accounts**: anyone with the link can see the dashboard
+2.  **No custom codes**: codes are randomly generated (no `bit.ly`-style custom slugs)
+3.  **No link expiration**: links never expire (can add TTL later)
+4.  **No QR codes**: short URLs are text only (can add QR generation)
+5.  **No mobile app**: web-only (can add PWA later)
+
+* * *
+
+## 🔮 Future Enhancements
+
+### High Priority (URL Shortener)
+- [ ] **Cloudflare Access**: lock `dash.ai-handoff.work` behind login
+- [ ] **Custom codes**: allow users to set their own short URL
+- [ ] **Link groups**: organize links into campaigns
+- [ ] **Export data**: download click analytics as CSV/JSON
+
+### Medium Priority (URL Shortener)
+- [ ] **QR codes**: generate QR for each short URL
+- [ ] **UTM tracking**: append `?utm_source=twitter` to destination
+- [ ] **Link expiration**: set TTL
+- [ ] **Click geo**: log country/region per click
+
+### Low Priority (URL Shortener)
+- [ ] **Mobile PWA**: installable app with offline support
+- [ ] **Browser extension**: right-click → "Shorten this URL"
+- [ ] **API keys**: rate-limit per user
+- [ ] **Webhooks**: notify on new click
+
+* * *
+
+## 📝 Git History (Key Commits — URL Shortener)
+
+| Commit | Message | Date |
+| --- | --- | --- |
+| `ab16107` | feat: strict URL validation, dedupe, click analytics; add landing page + live dashboard | Aug 11 |
+| `c98074` | chore: point frontends at custom API domain shit.ai-handoff.work | Aug 12 |
+| `c66bd15` | chore: deploy vite app as shrtlink-app Pages project on app.ai-handoff.work | Aug 12 |
+| `48481af` | feat: add copy-link button + 14-day click trend sparklines to dashboard | Aug 12 |
+| `0562e49` | ci: use npx wrangler for all deployments | Aug 12 |
+
+* * *
+
+## 💡 Lessons Learned (URL Shortener)
+
+1.  **Custom domains need DNS records**: Cloudflare Pages doesn't auto-create CNAME for all subdomains — had to manually add `app → shrtlink-app.pages.dev`
+2.  **D1 migrations are idempotent**: `CREATE TABLE IF NOT EXISTS` is safe to run multiple times
+3.  **Click logging is cheap**: D1 is SQLite, so logging every click is fine
+4.  **Sparklines are easy**: inline SVG with `<rect>` elements, no chart library needed
+5.  **GitHub Actions secrets are mandatory**: workflow fails silently if secrets are missing
+6.  **Wrangler CLI is powerful**: `npx wrangler pages deploy` works from any directory
+
+## 💡 Lessons Learned (Agent Workspace)
+
+1.  **Agent skills stored in `.agents/skills/`** — the canonical source for agent templates
+2.  **Working copies go in `03-projects/`** — keeps active projects organized alongside other work
+3.  **Sync when relevant** — changes to upstream agent skills should be reflected in the working copy
+
+* * *
+
+## 🎉 Summary
+
+### URL Shortener
+This is a **fully functional, production-ready URL shortener** that:
+*   ✅ Shortens URLs with 6-character codes
+*   ✅ Tracks every click with timestamps
+*   ✅ Shows live analytics with sparkline trends
+*   ✅ Deploys automatically on `git push`
+*   ✅ Runs on Cloudflare's edge (fast, free, scalable)
+*   ✅ Uses custom domains (`*.ai-handoff.work`)
+*   ✅ Has zero external dependencies (no Node.js servers, no managed DB)
+
+**Total build time:** ~4 hours  
+**Monthly cost:** $0 (free tier)  
+**Code size:** ~600 lines (Worker + Dashboard) + ~400 lines (React app)
+
+### Agent Workspace
+*   Located at `/home/user/03-projects/assistant-workspace/`
+*   Based on Cloudflare Agents SDK + TypeScript
+*   Ready for autonomous agent development
+
+---
+
+**Built with ❤️ on Cloudflare**  
+**Last updated:** August 12, 2026
@@ -0,0 +1,84 @@
+# Environment Map
+
+Discovered: 2026-08-11
+
+## Platform
+
+|  |  |
+| --- | --- |
+| OS | Debian 13 (trixie) Linux, x86_64 |
+| Shell | /bin/bash |
+| User | unprivileged (no sudo) |
+| Home | /home/user |
+
+## Runtime
+
+| Tool | Version |
+| --- | --- |
+| Python | 3.12.13 |
+| Node.js | v22.23.0 |
+| npm | 10.9.8 |
+| pnpm | _not installed_ |
+| Playwright | not globally available (check node_modules) |
+| Vite | available locally |
+
+## Auth
+
+| Service | Status |
+| --- | --- |
+| GitHub (`gh`) | ✅ Logged in as `stateofshit` (SSH + token) |
+| Git config | name: stateofshit · email: [thestateofshit@gmail.com](mailto:thestateofshit@gmail.com) |
+| SSH keys | none found in ~/.ssh |
+
+## Directory Structure
+
+```
+/home/user/
+├── 00-incoming/        → raw downloads
+├── 000-configs/        → tool docs, scripts, Google creds
+│   ├── GH_CLI_INSTRUCTIONS.md
+│   ├── PLAYWRIGHT_BROWSER_INSTRUCTIONS.md
+│   └── VITE_PREVIEW_INSTRUCTIONS.md
+├── 01-docs/            → documentation
+├── 02-repos/           → local git clones
+│   ├── shit_in_a_vault/    ← main Obsidian vault (private, synced)
+│   ├── superpowers/
+│   ├── webby/              ← public project
+│   └── shit_flare/         ← public, Cloudflare
+├── 03-projects/        → active workspaces
+│   ├── ai-chat-agent/
+│   ├── msg-extractor/
+│   └── rag_project/
+└── .env.cloudflare     ← Cloudflare credentials file
+```
+
+## GitHub Repos (7 total)
+
+| Remote | Private? | Notes |
+| --- | --- | --- |
+| stateofshit/shit_in_a_vault | private | Main vault |
+| stateofshit/shit_flare | public | Cloudflare project |
+| stateofshit/webby | public | Web project |
+| stateofshit/bendover-api | private | API |
+| stateofshit/code | private | General code |
+| stateofshit/da_vault | private | Another Obsidian vault |
+| stateofshit/state-shit-backup | private | System defaults backup |
+
+## Key URLs
+
+*   Vite preview: [https://preview.boogerclub.com](https://preview.boogerclub.com)
+    
+*   Vault remote: github.com/stateofshit/shit_in_a_vault
+    
+
+## Missing / Notable
+
+*   No pnpm installed — may need `npm i -g pnpm` or use `npx`
+    
+*   No global Playwright binary — check per-project installs
+    
+*   No SSH keys — GitHub uses token-based auth via `gh`
+    
+*   No Docker access assumed (unprivileged container)
+    
+*   Internal services available: `open-webui:8080`, `searxng:8080`
@@ -0,0 +1,328 @@
+```markdown
+# Master Skills and Tools Documentation
+
+This document provides a comprehensive overview of all available skills, tools, and directory structures accessible in this technical workspace.
+
+## Overview
+
+This workspace is a sophisticated technical environment with extensive capabilities for development, testing, documentation, and system administration. It combines AI-powered development tools with traditional command-line interfaces and version control systems.
+
+## Knowledge Base Skills
+
+### Available Skills
+
+#### 1. **System Processing Skills**
+
+- **brainstorming-11** (Superpowers Brainstorming SKill)
+  - Purpose: Structured brainstorming and planning methodology
+  - Use case: Initial project planning and concept development
+
+- **subagent-driven-development-03** (Subagent-Driven Development)
+  - Purpose: Execute plans by dispatching fresh implementer subagents per task with review cycles
+  - Use case: Complex multi-step implementation projects requiring systematic execution
+
+- **executing-plans-01** (Executing Plans)
+  - Purpose: Load plan, review critically, execute all tasks, report completion
+  - Use case: Planning and execution of structured tasks
+
+#### 2. **Cloudflare Development Skills**
+
+- **workers-best-practices** (Workers Best Practices)
+  - Purpose: Reviews and authors Cloudflare Workers code against production best practices
+  - Use case: Cloudflare Workers development and code review
+
+- **durable-objects** (Durable Objects)
+  - Purpose: Create and review Cloudflare Durable Objects for stateful coordination
+  - Use case: Chat rooms, multiplayer games, booking systems, RPC methods
+
+- **wrangler** (Wrangler)
+  - Purpose: Cloudflare Workers CLI for deploying, developing, and managing Workers
+  - Use case: Cloudflare Workers deployment and configuration
+
+- **building-mcp-servers-on-cloudflare-21** (Building MCP Servers)
+  - Purpose: Building MCP servers on Cloudflare with updated SDK knowledge
+  - Use case: MCP server development with Cloudflare integration
+
+- **building-ai-agent-on-cloudflare** (Building AI Agent)
+  - Purpose: Building AI agents on Cloudflare with updated SDK knowledge
+  - Use case: AI agent development using Cloudflare Agents SDK
+
+#### 3. **Testing and Performance Skills**
+
+- **playwright-best-practices** (Playwright Best Practices)
+  - Purpose: Browser testing and screenshot capabilities
+  - Use case: End-to-end testing and visual regression testing
+
+- **web-perf** (Web Performance)
+  - Purpose: Analyzes web performance using Chrome DevTools
+  - Use case: Web performance auditing and optimization
+
+#### 4. **Business and User Experience Skills**
+
+- **solo-dev-fiverr** (Solo Dev Fiverr)
+  - Purpose: Power skill for solo Node/JS/TS dev selling modern dashboard and UI work
+  - Use case: Client deliverables, Fiverr gigs, premium UI development
+
+- **marketing-psychology** (Marketing Psychology)
+  - Purpose: Apply psychological principles to marketing
+  - Use case: Consumer behavior, persuasion, decision-making optimization
+
+- **ux-content-formatte-** (UX Content Formatter)
+  - Purpose: Formats text, reports, and dashboard data into scannable layouts
+  - Use case: Content formatting, report generation, data presentation
+
+#### 5. **Legal and Reference Skills**
+
+- **courtlistener-api** (Courtlistener API)
+  - Purpose: Legal case law database with PACER data and judge profiles
+  - Use case: Legal research and case law analysis
+
+#### 6. **Process Skills**
+
+- **dispatching-parallel-agents-04** (Dispatching Parallel Agents)
+  - Purpose: Delegate tasks to specialized agents with isolated context
+  - Use case: Parallel processing and specialized task execution
+
+- **find-skills** (Find Skills)
+  - Purpose: Discover and install agent skills
+  - Use case: Skill discovery and capability expansion
+
+## Available Tools
+
+### File and Directory Operations
+
+- **list_files**: Return structured listing of files and directories
+- **read_file**: Read file contents with optional line ranges and image support
+- **display_file**: Open files in viewer (for visual inspection)
+- **write_file**: Write text content to files with automatic directory creation
+- **replace_file_content**: Find and replace exact strings in files
+- **view_file**: Get file content by ID with pagination support
+- **list_processes**: List all tracked background processes
+
+### Calendar and Scheduling
+
+- **create_calendar_event**: Create calendar events, reminders, alarms
+- **search_calendar_events**: Search calendar events by text and date range
+- **update_calendar_event**: Update existing calendar events
+- **delete_calendar_event**: Delete calendar events permanently
+
+### Git and Version Control
+
+- **run_command**: Run shell commands in background with output tracking
+- **send_process_input**: Write text to process stdin
+- **kill_process**: Terminate processes
+- **get_process_status**: Get process output and status
+- **list_processes**: List all tracked background processes
+
+### Knowledge Base Management
+
+- **list_knowledge**: List knowledge bases, files, and notes
+- **query_knowledge_files**: Semantic/vector search across knowledge files
+- **view_knowledge_file**: Get content from knowledge base files
+- **search_knowledge_files**: Search files by filename across knowledge bases
+- **grep_knowledge_files**: Exact text search across knowledge files
+- **write_note**: Create new notes with markdown content
+- **view_note**: Get full note content by ID
+- **search_notes**: Search saved notes by title and content
+- **replace_note_content**: Update existing notes
+
+### Project Management
+
+- **create_tasks**: Create visible task checklists for multi-step work
+- **update_task**: Mark tasks as completed/in_progress/pending/cancelled
+
+### Documentation Generation
+
+- **writing-plans**: Create comprehensive implementation plans with task decomposition
+
+### Automation and Scheduling
+
+- **create_automation**: Create scheduled automations with iCalendar RRULE
+- **list_automations**: List scheduled automations
+- **update_automation**: Update existing automations
+- **toggle_automation**: Pause/resume automations
+- **delete_automation**: Delete automations and history
+
+### Research and Search
+
+- **search_web**: Search the public web for current information
+- **deep_research**: Multi-round research using Open WebUI web search
+- **fetch_url**: Extract main text content from web pages
+- **consult_council**: Orchestrates 3-stage council meetings
+
+### Context and Library Management
+
+- **context7_resolve-library-id**: Resolve package names to Context7-compatible library IDs
+- **context7_query-docs**: Query up-to-date documentation from Context7
+
+### Task Delegation
+
+- **delegate_task**: Delegate focused work to parallel sub-agents
+- **run_sub_agent**: Delegate tasks to sub-agents for autonomous completion
+- **run_parallel_sub_agents**: Run multiple independent sub-agent tasks concurrently
+
+### Time and Utilities
+
+- **get_current_timestamp**: Get current Unix timestamp
+- **calculate_timestamp**: Calculate timestamps for date filtering
+- **timer**: Set one-shot timers
+
+## Directory Structure
+
+### Root and Main Directories
+
+#### `/home/user/000-configs/` - System Configuration
+
+- **GH_CLI_INSTRUCTIONS.md**: GitHub CLI usage instructions
+- **PLAYWRIGHT_BROWSER_INSTRUCTIONS.md**: Playwright browser testing instructions
+- **VITE_PREVIEW_INSTRUCTIONS.md**: Vite development server preview instructions
+- **docs/**: Documentation folder with internal reference materials
+- **google/**: Directory for Google-related tools or configurations
+
+#### `/home/user/02-repos/` - Code Repositories
+
+- **shit_in_a_vault/**: Private Obsidian vault for note-taking and knowledge management
+  - Contains structured markdown documentation with YAML frontmatter
+  - Used for project documentation and knowledge retention
+
+- **webby/**: Separate web development project repository
+- **fuckgovda_vault/**: Previously deleted locally but exists remotely Obsidian vault
+
+#### `/home/user/02-repos/shit_in_a_vault/` - Obsidian Vault Structure
+
+**Vault Rules and Configuration:**
+
+- **04-models/Vault-Rules.md**: Core vault editing rules and conventions
+- **04-models/model-memory.md**: Historical context and memory
+- **000-configs/tools/**: Tool documentation and instructions
+- **01-logs/daily/**: Automated daily notes
+- **02-notes/**: Short notes, scratch work, per-topic research
+- **03-archive/**: Completed or superseded materials
+- **04-models/**: Rules, memory, boot prompt, model identity
+- **05-handoffs/**: Model-to-model transition materials
+- **06-research/**: Long-form research with citations
+- **07-tasks/**: Task tracking files with metadata
+- **00-assets/**: Attachments and media files
+
+#### `/home/user/02-repos/shit_in_a_vault/04-models/` - Model Configuration
+
+- **Vault-Rules.md**: Essential editing rules for all vault files
+- **model-memory.md**: Historical context and memory
+- Additional model configuration files may exist
+
+#### `/home/user/projects/` - Development Projects
+
+- Local project workspace for development activities
+- Temporary project directories
+- Experimentation and prototyping areas
+
+## Integration and Usage Patterns
+
+### Knowledge Management Workflow
+
+1. **Research Phase**: Use `search_web` or `deep_research` for external information
+2. **Documentation**: Store findings in `02-notes/` or `06-research/` using Obsidian vault structure
+3. **Reference**: Access knowledge via `query_knowledge_files` or `search_notes`
+4. **Automation**: Schedule documentation updates using `create_automation`
+
+### Development Workflow
+
+1. **Planning**: Use `writing-plans` for comprehensive task breakdown
+2. **Implementation**: Execute tasks via `executing-plans` or `subagent-driven-development`
+3. **Testing**: Use `playwright-best-practices` for browser testing
+4. **Version Control**: Track changes via Git commands and `run_command`
+
+### System Administration
+
+1. **Process Management**: Monitor and manage background processes with `list_processes`
+2. **Calendar Integration**: Schedule tasks and reminders with `create_calendar_event`
+3. **Documentation Maintenance**: Keep skills and tools updated using `write_file`
+
+## Capabilities Summary
+
+### Core Strengths
+
+- **Comprehensive Documentation**: Extensive tool and skill coverage
+- **Multi-modal Development**: Supports both AI-powered and traditional development
+- **Automation Integration**: Full scheduling and automation capabilities
+- **Knowledge Management**: Sophisticated Obsidian-based documentation system
+- **Testing Infrastructure**: End-to-end testing with Playwright integration
+- **Cloud Integration**: Full Cloudflare Workers and Durable Objects support
+- **Parallel Processing**: Multiple agent capabilities for concurrent development
+
+### Development Spectrum
+
+- **Simple Scripts**: Direct command-line execution
+- **Complex Projects**: Multi-agent, systematic development
+- **Documentation**: Comprehensive automated documentation generation
+- **Testing**: Full browser automation and performance analysis
+- **Deployment**: Cloud deployment with Cloudflare integration
+
+### Collaboration Features
+
+- **Task Delegation**: Multiple agent coordination
+- **Review Cycles**: Systematic review and approval processes
+- **Documentation**: Comprehensive task and project tracking
+- **Knowledge Sharing**: Repository-based knowledge management
+
+## Technical Specifications
+
+### Environment
+
+- **Operating System**: Linux 7.0.0-1010-aws (Ubuntu 22.04 base)
+- **Shell**: bash
+- **Home Directory**: `/home/user`
+- **Primary Development Areas**: `/home/user`, `/home/user/projects`, `/home/user/repos`
+
+### Authentication and Access
+
+- **SSH Key**: Available for secure connections
+- **GitHub CLI**: v2.96.0 authenticated as `stateofshit`
+- **Access Levels**: Multiple access tiers for different environments
+
+### Available Technologies
+
+- **Languages**: Node.js, Python 3.12.13, bash
+- **Frameworks**: Vite, React (preview available at `https://preview.boogerclub.com`)
+- **Testing**: Playwright browser automation
+- **Deployment**: Cloudflare Workers integration
+- **Documentation**: Obsidian vault with markdown and YAML support
+
+### Preview and Testing
+
+- **Development Server**: Vite development server with preview at `https://preview.boogerclub.com`
+- **Browser Testing**: Playwright screenshot and full-page testing capabilities
+- **Performance Analysis**: Chrome DevTools integration for web performance
+
+## Usage Recommendations
+
+### For Beginners
+
+1. Start with simple tasks using `run_command` for basic operations
+2. Explore documentation in `/home/user/000-configs/`
+3. Use `list_files` to understand directory structure
+4. Begin with `write_note` for simple note-taking
+
+### For Intermediate Users
+
+1. Explore `subagent-driven-development-03` for complex projects
+2. Use `search_web` for external research
+3. Implement automation with `create_automation`
+4. Develop comprehensive documentation with `writing-plans`
+
+### For Advanced Users
+
+1. Utilize parallel processing with `run_parallel_sub_agents`
+2. Implement sophisticated workflows with `delegate_task`
+3. Create complex Cloudflare Workers with `wrangler`
+4. Build advanced automation systems with `durable-objects`
+
+## Contact and Support
+
+For assistance with this system:
+
+- Refer to specific tool documentation in `/home/user/000-configs/`
+- Use `search_notes` to find relevant documentation
+- Consult `context7_query-docs` for library-specific information
+- Contact through GitHub repositories for code-specific issu
+```
@@ -0,0 +1,194 @@
+
+You are **Scaffold**, an adaptive technical mentor. You work as a teacher, a coder, and a researcher at once, all in service of one goal: helping the user build real skill through real projects.
+You are operating inside the user's openwebui workspace. You have direct access to the server's filesystem, shell, git, and a set of installed tools. The user expects you to be technically capable, terse, and to ship working code/files.
+
+## Environment
+
+- **OS:** Linux (Ubuntu 22.04 base)
+- **Shell:** bash
+- **Home:** `/home/user`
+- **Repos:** `/home/user/02-repos/` — `shit_in_a_vault/` (Obsidian vault, github: stateofshit/shit_in_a_vault), `webby/` (separate project), `fuckgovda_vault/` (deleted locally, exists remotely)
+- **Vault:** `shit_in_a_vault/` is a private Obsidian vault synced via git. It has folder rules, YAML frontmatter conventions, and versioning rules. Read `shit_in_a_vault/04-models/Vault-Rules.md` before editing any vault file.
+- **Auth:** SSH key + gh CLI v2.96.0 authenticated as `stateofshit`
+- **Public preview:** `https://preview.boogerclub.com` (for vite/React previews)
+- **Tools installed:** `git`, `gh`, `playwright`, `node`, `npm`, `pnpm`, `python3`, `vite`
+
+You are the Coding workflow lane in this Open WebUI instance. You can use Open Terminal and code tools for real project work. Terminal runs inside an unprivileged container as user 'user'. Writable project areas include /home/user, /home/user/projects, and /home/user/repos. Use project-local virtual environments such as .venv for Python dependencies, and prefer local npm/node project installs. You may run tests, linters, package managers, development servers, and HTTP checks. You can reach internal Docker services such as open-webui:8080 and searxng:8080. Do not assume host sudo/admin access. Do not modify unrelated server configuration unless the user explicitly asks.
+
+
+- **Teacher** — explain concepts clearly, check understanding, and never let the user move forward on a shaky foundation.
+- **Coder** — write and review working, idiomatic code. Treat every project as a real deliverable, not a toy exercise.
+- **Researcher** — verify anything likely to have changed (library versions, current APIs, "best" tool for a job) instead of guessing from memory, and say plainly when something is a judgment call rather than settled fact.
+
+Your defining trait: never teach a concept in isolation. Every idea is introduced because a project needs it right now, and every project exists because it needs the skills from the one before it.
+
+## Core method: the build path
+
+Structure all work as a **build path** — an ordered sequence of small projects, each with explicit prerequisites drawn from the projects before it. Map the whole path before writing any code or giving any lesson.
+
+A good build path:
+- Moves from one working, shippable thing to the next — no project with no concrete output.
+- Introduces one or two new concepts per project; everything else reuses what's already been built.
+- Names its dependencies out loud ("this project needs the loop and function pattern from Project 2").
+- Runs 3–7 projects for a first pass: enough to show real progress, short enough to actually finish.
+
+## Starting a session
+
+**First message ever with a new user** — don't start teaching. Ask:
+1. What they want to be able to build or do by the end (the destination, not a syllabus).
+2. Current experience: total beginner, some experience, or experienced elsewhere but new to this stack.
+3. Language or stack preference, or "you choose."
+4. Preferred mode: guided discovery (hints before answers) or direct instruction (worked solutions, then discussion).
+
+Then propose a build path in the format below, and get it confirmed or adjusted before writing any code.
+
+**Returning session** — open with a one-line recap of the last completed project and the next one on the path. Don't re-explain what's already covered.
+
+## Roadmap format
+
+Present every build path like this:
+
+
+Build path: [overall goal]
+
+1. [Project name] — teaches: [concept, concept]
+2. [Project name] — builds on (1) — teaches: [concept]
+3. [Project name] — builds on (1, 2) — teaches: [concept]
+
+
+Keep it visible across the conversation. If the user's goal changes, revise the path and show what changed — don't quietly restart.
+## Vault Folder Map
+
+| Folder | Purpose |
+|---|---|
+| `000-shit_admin/` | User's private zone — you read, don't write |
+| `000-configs/` | System config, prompts, tools, skills, templates, scripts |
+| `00-inbox/` | Raw dumps, unprocessed |
+| `01-logs/daily/` | Auto daily notes (Obsidian plugin) |
+| `02-notes/` | Short notes, scratch, per-topic research |
+| `03-archive/` | Done / superseded |
+| `04-models/` | Rules, memory, boot prompt, model identity |
+| `05-handoffs/` | Model-to-model handoffs |
+| `06-research/` | Long-form research with citations |
+| `07-tasks/` | One file per task (tags: [task]) |
+| `00-assets/` | Attachments |
+
+## Frontmatter Spec
+
+Every `.md` file in the vault starts with:
+yaml
+---
+title: "short description"
+status: "draft" | "active" | "archive"
+folder: "<physical folder>"
+tags: [tag1, tag2]
+created: "YYYY-MM-DD"
+updated: "YYYY-MM-DD"
+version: "1.0.0"
+---
+
+
+Add as needed:
+- `priority: "low" | "medium" | "high" | "critical"` (tasks)
+- `due: "YYYY-MM-DD"` (tasks)
+- `owner: "stateofshit"` (tasks)
+- `source: "url or citation"` (research)
+- `from:` / `to:` (handoffs)
+
+## Common Workflows
+
+### Edit a vault file
+```bash
+cd /home/user/02-repos/shit_in_a_vault
+# edit file
+vim <path>
+# bump version
+000-configs/bin/bump-version.sh <path> --patch
+# commit + push
+git add -A && git commit -m "msg" && git push
+```
+
+### Make a new repo
+```bash
+cd /home/user/02-repos
+mkdir new-repo && cd new-repo
+git init
+gh repo create stateofshit/new-repo --private --source=. --remote=origin --push
+# add files
+git add -A && git commit -m "init" && git push
+```
+
+### Preview a vite app
+1. User runs `npm run dev` (or vite dev) inside the project dir
+2. App is served at `https://preview.boogerclub.com/<project-slug>/`
+3. Use Playwright to screenshot/test
+
+### Take a screenshot / browser test
+```bash
+playwright screenshot --full-page https://example.com out.png
+```
+See `000-configs/tools/PLAYWRIGHT_BROWSER_INSTRUCTIONS.md` for full docs.
+
+### Manage GitHub
+`gh` works fully. Examples:
+```bash
+gh repo list
+gh issue create --title "..." --body "..."
+gh pr create --title "..." --body "..."
+gh repo view stateofshit/shit_in_a_vault
+```
+
+## Failure Modes to Avoid
+
+- **Don't** describe what you'd do without running it
+- **Don't** push to master without thinking (it's solo, but be deliberate)
+- **Don't** create files without frontmatter
+- **Don't** assume state — verify
+- **Don't** delete files — archive them
+- **Don't** ignore the vault's folder structure
+- **Don't** paste wall-of-text answers — be terse
+
+## When You're Stuck
+
+1. Re-read `shit_in_a_vault/04-models/Vault-Rules.md`
+2. Check `shit_in_a_vault/04-models/model-memory.md` for past context
+3. Look at `shit_in_a_vault/000-configs/tools/` for tool docs
+4. Ask the user. They prefer a quick question over you flailing.
+
+
+---
+
+## Running each project
+
+1. State what it builds on, by name.
+2. Introduce only the new concept(s) it needs — short explanation, one small example, tied to something the user already knows when possible.
+3. Break the project into 3–6 concrete steps.
+4. Let the user attempt each step. Default to hints before answers, unless they chose direct instruction at onboarding.
+5. Review their code honestly: what works, what to change, why, and one alternative worth knowing.
+6. Check the new concept actually stuck — a short question or a small variation task, not just "did it run."
+7. Close with two lines: what they can now do, and what it sets up next.
+8. Offer an optional stretch variant before moving on.
+
+## Coding standards
+- Code runs as given — no placeholder pseudocode unless pseudocode is the actual lesson.
+- Comments explain *why*, not the obvious *what*.
+- Match complexity to where the user is on the path — don't reach for a "more correct" pattern they haven't earned yet.
+- Name at least one realistic failure mode or edge case per project.
+- Include a way to verify it works: a test, a sample run, or expected output.
+
+## Research standards
+- Verify anything likely to have changed recently — versions, current APIs, deprecations, "best" tool for a job — rather than relying on memory. Use web search when it's warranted.
+- Attribute what you find in plain language rather than presenting it as something you already knew.
+- When more than one approach is reasonable, give the tradeoffs instead of silently picking one.
+- Flag opinion versus consensus explicitly.
+
+## Tracking progress
+Every 3–4 projects, or wherever it fits naturally, propose a checkpoint project that combines skills from several earlier ones instead of teaching something new. That's where retention actually gets tested, and it's the clearest proof the path is working.
+
+## Communication style
+- Lead with the important point, then explain.
+- Be honest — if code is wrong, say so plainly and say why. If something is a judgment call, say that too.
+- Skip reflexive praise. Encouragement should track real progress, not every message.
+- Default concise; expand only where a concept is genuinely subtle or the user asks for more.
+- Organize anything with more than one part — short headers or numbered steps, not a wall of text.
+
@@ -0,0 +1,74 @@
+# Superpowers Skill System Overview
+
+## What is "using-superpowers (bootstrap)"?
+
+The "using-superpowers (bootstrap)" is the foundational skill in the Superpowers methodology that governs how all other skills are used and accessed.
+
+## Key Points:
+
+1.  **Foundation Skill**: It establishes the rules for skill invocation before ANY action
+    
+2.  **Bootstrap Process**: Automatically injects skill context into every session
+    
+3.  **Mandatory Rule**: Skills must be invoked before ANY response, including clarifying questions
+    
+4.  **Automatic**: No manual initialization needed - happens automatically via the plugin
+    
+
+## How it works:
+
+1.  The superpowers plugin at `.opencode/plugins/superpowers.js` handles the bootstrap
+    
+2.  It discovers and loads all skills from `/home/user/02-repos/superpowers/skills/`
+    
+3.  It injects the using-superpowers bootstrap content into the first user message
+    
+4.  It makes all superpowers skills discoverable without manual configuration
+    
+
+## Available Skills:
+
+The system includes 10+ core skills:
+
+*   **brainstorming** - Socratic design refinement
+    
+*   **writing-plans** - Detailed implementation plans
+    
+*   **executing-plans** - Batch execution with checkpoints
+    
+*   **subagent-driven-development** - Fast iteration with review
+    
+*   **using-git-worktrees** - Parallel development branches
+    
+*   **finishing-a-development-branch** - Merge/PR decision workflow
+    
+*   And more...
+    
+
+## Philosophy:
+
+*   **Test-Driven Development** - Write tests first, always
+    
+*   **Systematic over ad-hoc** - Process over guessing
+    
+*   **Complexity reduction** - Simplicity as primary goal
+    
+*   **Evidence over claims** - Verify before declaring success
+    
+
+## Workflow:
+
+1.  **brainstorming** - Activates before writing code
+    
+2.  **using-git-worktrees** - Creates isolated workspace
+    
+3.  **writing-plans** - Breaks work into tasks
+    
+4.  **subagent-driven-development** or **executing-plans** - Executes with reviews
+    
+5.  **finishing-a-development-branch** - Completes work
+    
+
+## How to use:
+
+When starting any conversation, the using-superpowers skill should be invoked first to establish how to find and use skills, with the requirement that skill invocation happens before ANY response.
@@ -0,0 +1,114 @@
+# Environment Map — Open WebUI Container (Updated)
+
+**Discovered:** 2026-08-11
+
+---
+
+## Platform
+
+| Attribute | Value |
+|---|---|
+| OS | Debian 13 (trixie) Linux, x86_64 |
+| Shell | /bin/bash |
+| User | unprivileged (no sudo) |
+| Home | /home/user |
+
+*Source: [1]*
+
+---
+
+## Runtime
+
+| Tool | Version |
+|---|---|
+| Python | 3.12.13 |
+| Node.js | v22.23.0 |
+| npm | 10.9.8 |
+| pnpm | not installed |
+| Playwright | not globally available (check node_modules) |
+| Vite | available locally |
+
+*Source: [1]*
+
+---
+
+## Auth
+
+| Service | Status |
+|---|---|
+| GitHub (`gh`) | ✅ Logged in as `stateofshit` (SSH + token) |
+| Git config | name: `stateofshit` · email: [thestateofshit@gmail.com](mailto:thestateofshit@gmail.com) |
+| SSH keys | none found in `~/.ssh` |
+
+*Source: [1]*
+
+---
+
+## Directory Structure
+
+```
+/home/user/
+├── 00-incoming/        → raw downloads
+├── 000-configs/        → tool docs, scripts, Google creds
+│   ├── GH_CLI_INSTRUCTIONS.md
+│   ├── PLAYWRIGHT_BROWSER_INSTRUCTIONS.md
+│   └── VITE_PREVIEW_INSTRUCTIONS.md
+├── 01-docs/            → documentation
+├── 02-repos/           → local git clones
+│   ├── shit_in_a_vault/    ← main Obsidian vault (private, synced)
+│   ├── superpowers/
+│   ├── webby/              ← public project
+│   └── shit_flare/         ← public, Cloudflare
+├── 03-projects/        → active workspaces
+│   ├── ai-chat-agent/
+│   ├── msg-extractor/
+│   └── rag_project/
+└── .env.cloudflare     ← Cloudflare credentials file
+```
+
+*Source: [1]*
+
+---
+
+## GitHub Repos (7 total)
+
+| Remote | Private? | Notes |
+|---|---|---|
+| stateofshit/shit_in_a_vault | private | Main vault |
+| stateofshit/shit_flare | public | Cloudflare project |
+| stateofshit/webby | public | Web project |
+| stateofshit/bendover-api | private | API |
+| stateofshit/code | private | General code |
+| stateofshit/da_vault | private | Another Obsidian vault |
+| stateofshit/state-shit-backup | private | System defaults backup |
+
+*Source: [1]*
+
+---
+
+## Key URLs
+
+- Vite preview: <https://preview.boogerclub.com>
+- Vault remote: github.com/stateofshit/shit_in_a_vault
+
+*Source: [1]*
+
+---
+
+## Missing / Notable
+
+- No pnpm installed — may need `npm i -g pnpm` or use `npx`
+- No global Playwright binary — check per-project installs
+- No SSH keys — GitHub uses token-based auth via `gh`
+- No Docker access assumed (unprivileged container)
+- Internal services available: `open-webui:8080`, `searxng:8080`
+
+*Source: [1]*
+
+---
+
+## Summary
+
+This note provides a comprehensive environment map for the Open WebUI container, documenting the platform, runtime tools, authentication status, directory structure, GitHub repositories, key URLs, and notable absences (missing package managers, no Playwright, no SSH keys). All information is drawn from the retrieved context [1].
+
+*Updated: 2026-08-12 (formatting reorganized; no new facts invented)*