feat: {{Linux:}} tag — full Debian Linux terminal via WebVM

- New {{Linux:}} markdown tag with Packages: field for package badges
- Opens WebVM (webvm.io) in a new browser window with full keyboard support
- Toolbar 🐧 Terminal button inserts tag template
- Card shows running status and Focus/Launch button
- Persistent sessions via IndexedDB across page reloads

New files:
- js/linux-docgen.js — parsing, transform, bind, and launch logic
- css/linux-terminal.css — card, badge, status, button styles
- CHANGELOG-linux-terminal.md

Modified:
- renderer.js — transform chain + DOMPurify whitelist
- main.js — CSS + module imports
- index.html — CSP frame-src + toolbar button
- help-mode.js — help entry
- templates/coding.js — Linux Terminal template
- templates/documentation.js — Feature Showcase updated
- README.md — features table, technologies, release notes

Author: ijbo

CHANGELOG-linux-terminal.md

@@ -0,0 +1,24 @@
+# CHANGELOG — Linux Terminal Tag
+
+## 2026-03-08
+
+### Added
+- **`{{Linux:}}` tag** — new markdown tag that opens a full Debian Linux terminal (WebVM) in a new browser window
+  - `Packages:` field for specifying packages to install, rendered as visual package badges
+  - Toolbar 🐧 Terminal button inserts the tag template
+  - Card renders with launch/focus button and running status indicator
+  - WebVM opens in a centered popup window with full keyboard support
+  - Session persistence via IndexedDB across page reloads
+
+### New Files
+- `js/linux-docgen.js` — Core component: parsing, transformation, binding, and launch logic
+- `css/linux-terminal.css` — Card, badge, status, and toolbar button styles
+
+### Modified Files
+- `js/renderer.js` — Added `transformLinuxMarkdown` to transform chain and `bindLinuxPreviewActions` to post-render actions; updated DOMPurify whitelist for `data-linux-index`
+- `src/main.js` — CSS import (`linux-terminal.css`) and dynamic module import (`linux-docgen.js`)
+- `index.html` — CSP `frame-src` updated for `webvm.io`; toolbar 🐧 Terminal button added
+- `js/help-mode.js` — Help entry for Linux Terminal toolbar button
+- `js/templates/coding.js` — Linux Terminal coding template
+- `js/templates/documentation.js` — Feature Showcase updated with Linux Terminal
+- `README.md` — Features table, technologies, and release notes updated

README.md

@@ -38,6 +38,7 @@
 | **🔌 API Calls** | `{{API:}}` REST API integration — GET/POST/PUT/DELETE methods, custom headers, JSON body, response stored in `$(api_varName)` variables; inline review panel; toolbar GET/POST buttons |
 | **🔗 Agent Flow** | `{{Agent:}}` multi-step pipeline — define Step 1/2/3, chain outputs, per-card model + search provider selector, live step status indicators (⏳/✅/❌), review combined output |
 | **🔍 Web Search** | Toggle web search for AI — DuckDuckGo (free), Brave Search, Serper.dev; search results injected into LLM context; source citations in responses; per-agent-card search provider selector |
+| **🐧 Linux Terminal** | `{{Linux:}}` tag opens a full Debian Linux terminal ([WebVM](https://webvm.io)) in a new window — `Packages:` field for install reminders; package badges; toolbar 🐧 Terminal button; persistent sessions via IndexedDB |
 | **❓ Help Mode** | Interactive learning mode — click ❓ Help to highlight all buttons, click any button for description + keyboard shortcut + animated demo video; 50% screen demo panel with fullscreen expand; 16 dedicated demo videos mapped to every toolbar button |
 | **Extras** | Auto-save (localStorage + cloud), table of contents, image paste, 96+ templates (12 categories: AI, Agents, Coding, Maths, PPT, Quiz, Tables, Documentation, Project, Technical, Creative, Financial), template variable substitution (`$(varName)` with auto-detect), table spreadsheet tools (sort, filter, stats, chart, add row/col, inline cell edit, CSV/MD export), content statistics, modular codebase (13+ JS modules), fully responsive mobile UI with scrollable Quick Action Bar (Files, Search, TOC, Share, Copy, Tools, AI, Model, Upload, Help) and formatting toolbar, multi-file workspace sidebar, compact header mode with collapsible Tools dropdown (Presentation, Zen, Word Wrap, Focus, Voice, Dark Mode, Preview Theme) |
 
@@ -337,6 +338,7 @@ Headings · **Bold** · *Italic* · ~~Strikethrough~~ · Links · Images · Orde
 | [just-bash](https://justbash.dev/) | In-browser bash execution |
 | [Pyodide](https://pyodide.org/) | In-browser Python (CPython via WASM) |
 | [sql.js](https://sql.js.org/) | In-browser SQLite (WASM) |
+| [WebVM](https://webvm.io) | Full Debian Linux terminal (CheerpX x86 emulation) |
 
 ## 🤝 Contributing
 
@@ -360,6 +362,7 @@ TextAgent has undergone significant evolution since its inception. What started
 
 | Date | Feature / Update |
 |------|-----------------|
+| **2026-03-08** | 🐧 **Linux Terminal** — new `{{Linux:}}` tag opens a full Debian Linux terminal ([WebVM](https://webvm.io)) in a new browser window; `Packages:` field for package reminders with visual badges; persistent sessions via IndexedDB; toolbar 🐧 Terminal button; Linux Terminal coding template; fully independent module (`linux-docgen.js`) |
 | **2026-03-08** | 🔌 **API Component** — new standalone `{{API:}}` tag for REST API calls directly in markdown; supports GET/POST/PUT/DELETE methods, custom headers, JSON body, and `Variable:` to store response in `$(api_varName)`; toolbar GET/POST buttons insert templates; API cards render inline with method badge + URL; execute with ▶ button, review response with Accept/Regenerate/Reject; response variables accessible via ⚡ Vars table; fully independent module (`api-docgen.js`) separated from AI component |
 | **2026-03-08** | 🏷️ **Template display tags** — AI templates now show `AI` flavor tags; agent templates show `AI · Agent` tags on template cards for quick visual identification of template type |
 | **2026-03-08** | 📜 **MIT License** — changed project license from Apache 2.0 to MIT for broader compatibility and simpler terms |

css/linux-terminal.css

@@ -0,0 +1,101 @@
+/* ============================================
+   linux-terminal.css — {{Linux:}} tag styles
+   ============================================ */
+
+/* --- Terminal Card --- */
+.linux-terminal-card {
+    border-color: var(--linux-accent, #22c55e) !important;
+}
+
+.linux-terminal-card .ai-placeholder-icon {
+    font-size: 1.3rem;
+}
+
+.linux-terminal-card .ai-placeholder-header {
+    background: linear-gradient(135deg, rgba(34, 197, 94, 0.08), rgba(34, 197, 94, 0.03));
+}
+
+/* --- Package badges --- */
+.linux-packages {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px;
+    padding: 8px 14px 10px;
+    border-top: 1px solid var(--border-color, rgba(125, 133, 144, 0.2));
+}
+
+.linux-pkg-badge {
+    display: inline-flex;
+    align-items: center;
+    padding: 2px 10px;
+    font-size: 0.75rem;
+    font-family: 'SF Mono', 'Consolas', 'Menlo', monospace;
+    border-radius: 12px;
+    background: rgba(34, 197, 94, 0.1);
+    color: #22c55e;
+    border: 1px solid rgba(34, 197, 94, 0.25);
+    letter-spacing: 0.01em;
+}
+
+[data-theme="light"] .linux-pkg-badge {
+    background: rgba(34, 197, 94, 0.08);
+    color: #15803d;
+    border-color: rgba(34, 197, 94, 0.3);
+}
+
+/* --- Status indicator --- */
+.linux-status-running {
+    color: #22c55e;
+    font-size: 0.7rem;
+    font-weight: 600;
+    margin-left: 8px;
+    animation: linux-pulse 1.5s ease-in-out infinite;
+}
+
+@keyframes linux-pulse {
+
+    0%,
+    100% {
+        opacity: 1;
+    }
+
+    50% {
+        opacity: 0.4;
+    }
+}
+
+/* --- Info text --- */
+.linux-info {
+    padding: 6px 14px 8px;
+    border-top: 1px solid var(--border-color, rgba(125, 133, 144, 0.2));
+    color: #8b949e;
+    font-size: 0.75rem;
+}
+
+/* --- Launch button --- */
+.linux-launch {
+    background: rgba(34, 197, 94, 0.12) !important;
+    color: #22c55e !important;
+    border: 1px solid rgba(34, 197, 94, 0.3) !important;
+    font-weight: 600;
+    padding: 3px 12px !important;
+    border-radius: 6px !important;
+    font-size: 0.78rem !important;
+    transition: all 0.2s ease;
+}
+
+.linux-launch:hover {
+    background: rgba(34, 197, 94, 0.25) !important;
+    transform: translateY(-1px);
+}
+
+/* --- Toolbar button --- */
+.fmt-linux-btn {
+    color: #22c55e !important;
+    font-weight: 700;
+    font-size: 0.7rem !important;
+}
+
+.fmt-linux-btn:hover {
+    background: rgba(34, 197, 94, 0.15) !important;
+}

index.html

@@ -27,7 +27,7 @@
         font-src 'self' https://cdnjs.cloudflare.com https://cdn.jsdelivr.net;
         worker-src 'self' blob:;
         child-src 'self' blob:;
-        frame-src 'self' blob:;
+        frame-src 'self' blob: https://webvm.io;
         object-src 'none';
         base-uri 'self';
     ">
@@ -621,6 +621,12 @@ <h5>Menu</h5>
                     title="Insert POST API call">POST</button>
             </div>
             <span class="fmt-separator"></span>
+            <div class="fmt-linux-group" title="Linux Terminal">
+                <span class="fmt-api-group-label" style="color:#22c55e">Linux</span>
+                <button class="fmt-btn fmt-linux-btn" data-action="linux-tag" title="Insert Linux Terminal tag">🐧
+                    Terminal</button>
+            </div>
+            <span class="fmt-separator"></span>
             <button class="fmt-btn fmt-vars-btn" id="apply-vars-btn"
                 title="Apply Variables — replace all $(varName) placeholders">
                 <i class="bi bi-braces-asterisk"></i> <span>Vars</span>

js/help-mode.js

@@ -253,6 +253,12 @@
             shortcut: null,
             demo: 'assets/demos/15_ai_doc_tags.webp'
         },
+        '[data-action="linux-tag"]': {
+            name: 'Linux Terminal Tag',
+            desc: 'Insert a {{Linux:}} block that embeds a full Debian Linux terminal (WebVM) in your document. Specify packages to auto-install — e.g. Packages: curl, vim, htop.',
+            shortcut: null,
+            demo: 'assets/demos/15_ai_doc_tags.webp'
+        },
         '#docgen-fill-btn': {
             name: 'Fill All AI Blocks',
             desc: 'Process all {{AI:}}, {{Think:}}, {{Image:}}, {{Agent:}}, and {{API:}} tags in the document. Each block generates independently and can be accepted, rejected, or regenerated.',