MCPcopy Create free account
hub / github.com/aaronnat23/disp8ch

github.com/aaronnat23/disp8ch @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
6,691 symbols 21,730 edges 990 files ⚖ MIT 73 documented · 1% updated 41d ago★ 100

Browse by type

Functions 6,360 Types & classes 331
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

disp8ch: local-first AI workspace

disp8ch

Website: disp8ch.com MIT license Node.js 22.13 or newer Local-first: runs fully offline PRs welcome

Chat in plain English. Get real workflows, real decisions, and shipped work. One app. Your machine. Your data.

Website · Install · Why disp8ch · Screenshots · First Prompts · Run Fully Local · All Features · FAQ


Most AI tools give you a chat box. disp8ch gives your chat box a company to run.

Tell it "build a daily 9 AM research digest and send it to my WebChat" and it drafts a real, editable workflow on a visual canvas (triggers, nodes, schedules) and asks before saving. Record a product discussion and turn its cited decisions into assigned work. Let a planner, implementer, and independent reviewer complete an acceptance contract, then inspect the evidence before publishing the result. Everything runs self-hosted, works with fully local models (no API key needed), and every side effect is approval-gated and auditable. No hidden prompt chains, no silent writes.

Built During OpenAI Build Week

Before the Submission Period: Disp8ch was already a working, local-first workspace built and tested over two months with GPT-5.5. Its existing foundation connected WebChat, visual workflows, Boards, Hierarchy, Council, Data Sources, Memory, Skills, Design Studio, channels, approvals, and Activity.

Built for OpenAI Build Week with Codex and GPT-5.6: The submission adds the missing delivery loop around that foundation: consent-gated Live Sessions and timestamp-cited Delivery Briefs; real planner, implementer, and independent reviewer workers; acceptance contracts, bounded repair, executable proof, and Outcome Receipts; source-grounded Files Projects; governed preview, publishing, and feedback-to-revision; and outcome-first Cross-Tab Work Trails that keep the decision, owners, evidence, code, cost, approval, and public result connected.

Codex with GPT-5.6 was used throughout the Submission Period to inspect the existing architecture, implement and refactor these changes, test cross-tab behavior on Windows, diagnose live-model and UI failures, harden security and dependencies, and prepare the release and demo evidence. Inside Disp8ch, GPT-5.6 can also be selected through the operator's authenticated Codex session as the planner and independent reviewer for a Supervised Run, while a faster or lower-cost configured model performs implementation. Disp8ch does not copy or expose the operator's Codex OAuth token.

The human operator chose the product scope, user problem, model policy, safety boundaries, acceptance criteria, and release decisions. External publishing, mutations, credentials, and untrusted feedback remain explicitly confirmation-gated. The included demo presents the Build Week work as an extension of the pre-existing product, not as a claim that one prompt created the full application.

⚡ Install in 30 seconds

Linux, macOS, or WSL

curl -fsSL https://raw.githubusercontent.com/aaronnat23/disp8ch/main/scripts/install.sh | bash -s -- --repo https://github.com/aaronnat23/disp8ch.git

Windows PowerShell

$env:DISP8CH_SOURCE_ZIP_URL = "https://github.com/aaronnat23/disp8ch/archive/refs/heads/main.zip"; iex (irm "https://raw.githubusercontent.com/aaronnat23/disp8ch/main/scripts/install-windows.ps1")

The installer sets up a managed Node runtime if needed, starts the app at http://localhost:3100, and opens onboarding. Connect a cloud key or a local model (Ollama, llama.cpp, LM Studio, vLLM, SGLang) and you're working. More options in Quick Start.

🦞 Why disp8ch

  • 🗣️ Plain English becomes real automation. Describe a workflow; get an inspectable node graph you can edit, test, replay, and schedule, with 57 templates included. Not a black-box prompt chain.
  • 🏛️ Decisions get a courtroom. Council sessions make agents argue options, vote, and record a verdict, with the losing side's concerns kept on the record.
  • 🏢 Agents get an org chart. Roles, goals, reporting lines, budgets, heartbeats, and cost attribution: a company-style control plane, not 20 lost terminal tabs.
  • 🧠 Memory you can actually read. Scoped, reviewable memory files on disk with promotion queues and conflict flags. The agent learns; you stay in charge of what it keeps.
  • 📚 Answers with receipts. Upload files, crawl docs sites, build notebooks, and get cited answers, then turn them into tasks, workflows, or council debates in the same app.
  • 🎙️ Meetings become accountable work. Capture a consent-gated transcript, ask timestamp-cited questions, save a Delivery Brief, and hand confirmed findings into the existing work system.
  • ✅ Completion requires proof. Supervised Runs separate planning, implementation, and review, then preserve acceptance criteria, evidence, cost, model assignments, and repair history in one receipt.
  • 🧭 Repositories stay inspectable. Connect an allowlisted project, ask grounded questions, open exact source ranges, inspect working-tree impact, preview the result, and hand verified work across tabs.
  • 🔌 Any model, including none of the cloud. Direct providers, OpenRouter, or fully offline with local OpenAI-compatible runtimes. A built-in advisor recommends what fits your RAM/VRAM.
  • 🔒 Nothing moves without your say-so. Read-only agent runtime; every mutation goes through typed, confirmation-gated actions with an audit trail. Risky workflow effects require explicit grants.

📸 See It

disp8ch dashboard

Dashboard: live system health, active workflows, agents, board tasks, and quick actions in one operator view.

disp8ch webchat disp8ch workflow canvas with connected template nodes

WebChat is the plain-English control surface for the whole workspace. Workflows is the visual canvas it builds on: trigger → org context → agent brief → council/board follow-up → output.

disp8ch Council court showing the multi-agent deliberation transcript and recorded verdict

Council: agents debate live on a court stage, vote, and the chamber records the verdict and the dissent.

disp8ch full agent organization hierarchy

Hierarchy: the whole agent organization at a glance: roles, goals, reporting lines, heartbeats, budgets, and workload.

disp8ch boards disp8ch data sources

disp8ch memory explorer disp8ch skills library

disp8ch agentic workspace loop

One operating loop: a research brief can become a cited answer, then a Council decision, then a Hierarchy goal, then workflow-backed board tasks, then a saved design artifact, with one audit trail instead of five separate apps.

💬 Try These First

What can this app currently do? Separate implemented, configured, and callable.
Build a daily 9 AM research digest workflow, but ask before saving if anything is ambiguous.
Start a council session on whether we should prioritize reliability or new features.
Spin up a research team, put them in an org, and give them a board task to compare OCR models.
Start a live product discussion, save a cited delivery brief, and propose the confirmed actions for review.
Connect this repository, explain the release gate from the real source, and open the exact lines.
Run a supervised delivery with acceptance criteria and stop for me if independent review cannot prove them.
Create a board task for each blocker in this launch document.
Remember that I prefer concise technical answers. Reply only saved.

More in WebChat Examples, including repo audits, cited research briefs, and design generation.

⭐ If disp8ch looks useful, star the repo. It is the best way to help other people find a local-first alternative. Found a rough edge? Open an issue; bug reports are gifts.


How The Tabs Work Together

disp8ch is built around one operating loop, not a pile of disconnected tools:

  1. Data Sources ingests PDFs, documents, scraped pages, crawled docs sites, and connected-source snapshots into searchable context.
  2. WebChat asks questions over that context, inspects app state, proposes plans, creates tasks, drafts workflows, and hands work to agents.
  3. Council turns important decisions into structured debate with recorded options, votes, and verdicts.
  4. Hierarchy assigns goals to organizations, roles, agents, budgets, reporting lines, heartbeats, and governance rules.
  5. Workflows turns repeatable work into triggerable automations with cron, webhooks, RSS, channels, files, documents, memory, boards, agents, and response nodes.
  6. Boards tracks the follow-up work created by WebChat, Council, Hierarchy, Data Sources, channels, or workflow outputs.
  7. Capabilities keeps Memory, Skills & Extensions, and MCP Servers together without mixing their responsibilities. Hierarchy Ops can merge an approved skill/extension preset into an existing team, while MCP access is scoped separately per server.
  8. Operations keeps Activity, Usage & Costs, and Maintenance visible; approvals, workflow-run detail, logs, and debug tools remain one click away under More tools when needed.
  9. Design Studio saves generated artifacts into the same workspace, so a design can become a board task, workflow, source, or decision instead of a one-off image.
  10. Live Sessions turns consented discussions into timestamped transcripts, cited findings, and a Delivery Brief that can enter the same governed work paths.
  11. Files Projects connects allowlisted repositories for source-grounded questions, structure and change impact, preview, supervised delivery, and publishing.

That means a research brief can become a cited WebChat answer, then a Council decision, then a Hierarchy goal, then workflow-backed board tasks, then a saved design artifact, with one audit trail instead of five separate apps.

Core Features

Agentic WebChat

  • One plain-English control surface for the whole app: ask questions, inspect state, run research, and hand work to agents.
  • Build and edit workflows from chat: create from a template, run, activate, or change a node's prompt, model, or config. Every change is a typed action you confirm first; nothing mutates until you approve.
  • Real evidence, not vibes: tool-backed research, source and file grounding, post-answer verification, and honest handling of missing evidence.
  • Depth on demand: rich answers by default, "keep it short" for compact ones, "thorough" for maximum depth.
  • Risk-gated code edits with changed-file accounting and behavioral verification probes.

Visual Workflow Automation

  • Drag-and-drop canvas covering triggers (message, webhook, cron, manual, GitHub), agents, HTTP, RSS, files, documents, memory, logic, boards, and channels.
  • 57 templates plus a recipe pack for common jobs: issue triage, PR review, uptime watch, news digests, scheduled reports, docs crawling, and more.
  • Test as you build: node testing, run-to-node, replay, execution traces, versions, and retry from the failed node.
  • Guardrails for unattended runs: per-workflow concurrency (skip duplicates or queue them durably), daily run/cost budgets with optional auto-disable, and escalation policies with quiet hours.
  • Notify only on change: a node can emit [SILENT] and downstream sends stay quiet until something actually needs attention.
  • Webhook workflows can answer the HTTP caller directly with a response node, and workflow JSON from other visual automation tools imports with unsupported nodes kept as visible placeholders.

Dynamic Runs And Agent Harnesses

  • /loop <objective> turns a long-running goal into a durable phase/worker run with pause, resume, cancel, and restart, visible in the Workflows tab.
  • Saved run commands make useful autonomous jobs repeatable.
  • Ready-made harnesses: a five-phase Project Manager workflow for repo work and a read-only Repo Audit pattern for quick health reports.
  • Supervised mode resolves separate planner, implementer, and rev

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 6,175
Interface 289
Method 185
Class 42

Languages

TypeScript100%
Python1%

Modules by API surface

src/lib/channels/router/index.ts265 symbols
scripts/cli.ts132 symbols
src/lib/engine/tools/index.ts117 symbols
src/app/(operator)/hierarchy/client-page.tsx74 symbols
src/lib/channels/app-action-executor.ts70 symbols
src/lib/memory/manager.ts69 symbols
src/lib/channels/app-action-planner.ts66 symbols
src/lib/workflows/templates/index.ts63 symbols
src/lib/documents/store.ts54 symbols
src/lib/workspace/files.ts52 symbols
src/lib/learning/loop.ts52 symbols
src/lib/channels/universal-agentic-runtime.ts52 symbols

For agents

$ claude mcp add disp8ch \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page