MD-OS

Launch Demo

The launch demo should show the core MD-OS (Artificial Prefrontal Cortex) v5.0 idea in under one minute:

Markdown program -> compiler -> AI host action -> MCP adapter -> bounded tool -> Markdown state update

Split-Screen Storyboard

Left side:

• MCP-compatible host or terminal client
• host calls mdos_register_signal
• host can call mdos_compile_programs
• host then calls mdos_build_project or mdos_replay

Right side:

• Obsidian opened at the MD-OS (Artificial Prefrontal Cortex) v5.0 workspace
• md-os/ops/global_index.md
• md-os/ops/agenda/global_agenda.md
• md-os/ops/projects/demo_general_system/agenda.md
• md-os/ops/projects/demo_general_system/work_items.ndjson if showing raw state

Demo Flow

1. Start from a fresh workspace:

npx --package md-os-apfc cortex init my-agent-os
cd my-agent-os

1. Open the folder in Obsidian.

2. Start the MCP server:

npm run mcp:server

1. In the host, call:

mdos_register_signal

with:

{
  "project_id": "demo_general_system",
  "summary": "Prepare the MD-OS launch demo with Obsidian-visible runtime state."
}

1. Show Obsidian updating:

md-os/ops/projects/demo_general_system/agenda.md
md-os/ops/agenda/global_agenda.md
md-os/ops/global_index.md

1. Call:

mdos_replay

1. End on:

matched_before: true

README Caption

Use a short caption above the GIF:

An agent writes state through MCP. MD-OS rebuilds readable Markdown. Obsidian
shows the agent's memory and agenda as normal files.

Launch One-Liner

MD-OS (Artificial Prefrontal Cortex) v5.0 is a Markdown-native Operating Filesystem for persistent AI agents, robotic systems, and host tooling: MCP-compatible, Obsidian-friendly, and built on readable files instead of hidden state.

This site is open source. Improve this page.