🧠 Ompcord

TL;DR 🚀 Ompcord keeps your Pi coding agent online in Discord. Amy is the bot persona. Each session runs in its own thread off a home channel; a single embed dashboard updates in place with live progress (todo checklists, status, steps) and relocates to stay “sticky” at the bottom of the thread. Administrative config settings are modified live via dropdown select menus.

---

⚡ 60-Second Quick Start

1. 🤖 Create Application & Bot (Discord Developer Portal) → Enable Message Content intent → Reset Token (copy).
2. 🔗 Invite Link (Bot + applications.commands scopes, perms 326417632336): https://discord.com/api/oauth2/authorize?client_id=APP_ID&scope=bot%20applications.commands&permissions=326417632336
3. 🏠 Home Channel: Set a text channel (e.g. #amy). Sessions run as threads inside it.
4. ⚙️ Config: Put Amy credentials in ~/.omp/.env (OMPCORD_DISCORD_BOT_TOKEN, guild, home channel, allow-list). Run node ~/pi-discord-amy/scripts/bootstrap-amy-env.mjs, then sudo systemctl enable --now amyd.service. See Deployment & always-on — never reuse DISCORD_BOT_TOKEN from ~/.hermes/.env (that is Hoe).
5. 💬 Talk: Use /amy new to start a thread, /amy say to prompt, or chat directly in session threads.

---

🧬 Core Architecture & UX Upgrades

📌 1. Interactive Pinning

• Prompt Pinning: Choice prompts (askViaDashboard) are automatically pinned to the thread header.
• Auto Release: Unpinned immediately upon user response, skip, or timeout.
• Clean Logs: Auto-deletes Discord’s system pinning notice to prevent clutter.

📋 2. Embed-Based Todo Checklists

• State Machine: Embed changes color based on agent mode (idle: Green, processing: Blurple, asking/confirming: Yellow, failed: Red).
• Inline Grid Routing: Completed/future phases are rendered as compact inline fields (inline: true). The active phase is expanded as a checklist block (inline: false) for mobile readability.
• Limit Defense: Auto-compresses and truncates long checklists to respect Discord’s 6000-character embed limit.

⤓ 3. Sticky Dashboard (Leapfrog Relocation)

• Log Offset Check: When text/code logs push the dashboard up, the bot archives the old message (turns it neutral gray, removes buttons, updates footer) and spawns a fresh live dashboard at the bottom.
• Rate Limit Shield: Debounces relocation. Only repositions if at least 2 messages have been posted since the last dashboard update.

🎛️ 4. Unified Status & Config Control Panel

• Slash Diagnostics: /amy status / /amy health display gateway stats, active run metrics, and feature flags.
• Interactive Toggles: Dropdown string select menus (amystatus:toggle_config) allow administrators to toggle reactions, toolResponses, autoStart, useThreads, and logDetail dynamically. Saved back to config.json instantly.

---

🎚️ Slash Commands (Guild-Scoped)

Use either /amy or /ompcord; both command names expose the same subcommands.

---

🧠 Brainstorm: The Pagination Screen Pattern

To print massive code blocks/logs without message spam, we can convert messages into interactive screens using buttons:

🎛️ Component Design

• Nav Row: [◀ Prev] [ Page 1/N ] [ Next ▶]
• SSOT Buffer: Instead of chunking into multiple new messages, Ompcord splits the output into pages ($\le 1900$ chars each) and stores them in memory/session.
• In-Place Edit: Clicking Next ▶ edits the same message with the next chunk.
• Timeout/Freeze: After the turn ends or after a 5-minute idle timeout, buttons are stripped to freeze the finalized page.

---

📋 Constants & Limits Reference

• 🔐 Permissions Int: 326417632336 (View, Send, Embed Links, Attach Files, Add Reactions, Read History, Manage Channels, Create Public Threads, Send in Threads).
• 📏 Limits: Message $\le 2000$ chars · Select menu $\le 25$ options · Component grid $\le 5$ rows · Modal $\le 5$ text fields · Embed description $\le 4096$ chars · Field value $\le 1024$ chars · Interaction ACK $\le 3\text{s}$ (then 15m to edit).
• 📂 CLI Continuity: Resume Discord threads locally using: omp --allow-home --cwd /home/usr --session-dir ~/.omp/amy-sessions/<thread-id> -c

Related Pages

• Flow Canvas (DRAFT placeholder) — aliases only; not flow SSOT until migrated
• Deployment & Always-On — Systemd services, environment variables, and daemon logs
• Embed Placeholders — Compact fields and limit defense templates
• Handoff — ecosystem research (historical)
• Responsive Interviews — UI and buttons for interactive prompt pinning
• Session Continuity — CLI resume commands and history tree continuity
• SSOT Status Dashboard — Status commands, health endpoints, and toggle configurations