markdown-agent-studio

Markdown Agent Studio

A browser IDE for defining, running, and observing multi-agent workflows from Markdown files.

Highlights

• Agent definitions in agents/*.md with YAML frontmatter.
• Real-time run visualization in a graph view.
• Inspector panels for Chat, Events, and Memory.
• Event-log restore/replay support.
• Built-in scripted demo mode when no API key is provided.
• Gemini-backed live runs when an API key is set.

Quick Start

Requires Node.js 20.19+.

git clone https://github.com/RobThePCGuy/markdown-agent-studio.git
cd markdown-agent-studio
npm install
npm run dev

Open http://localhost:5173.

Configuration

cp .env.example .env.local

Set:

VITE_GEMINI_API_KEY=your_key_here

npm Usage

Install:

npm install markdown-agent-studio

Use exported dist path:

import distPath from 'markdown-agent-studio';

Run immediately with npx (starts local static server and opens your browser):

npx markdown-agent-studio

Options:

• --port 4173
• --host 127.0.0.1
• --no-open

Or host distPath with your own static server.

Key Commands

• npm run check:all
• npm run release -- patch (or minor / major)
• npm run commit:publish -- --message "chore(release): vX.Y.Z" --bump patch
• npm publish --access public (use --provenance only in supported CI, e.g. GitHub Actions)

Docs

• Full guide: https://github.com/RobThePCGuy/markdown-agent-studio/blob/main/docs/README_FULL.md
• Release script: scripts/release.sh

License

MIT