Your AI Agent,
Driven by Text
Edit a Markdown file. Save. Your AI agent responds — right inside the file. No app switching. No cloud lock-in. Works with any editor.
## My Notes
/translate(English) 量子纠缠是一种奇特的物理现象
The Problem with Today's AI Tools
Current AI assistants force you into their ecosystem. ChatMarkdown takes a different approach.
Data Trapped in the Cloud
Your conversations, notes, and data live on someone else's server. Platform shuts down? Data gone.
AI Hallucination Risk
AI-centric agents let LLMs make every decision. Same prompt, different results. Unpredictable tool calls.
Platform Lock-in
Must use a specific app, browser, or terminal. Offline? Completely useless. Switching costs are huge.
How It Works
Three steps. That's it.
Install & Init
pip install chatmd
chatmd init ~/workspace
Start Agent
chatmd start
# Agent watches your files
Edit & Save
/ask What is quantum entanglement?
→ AI responds in your file
Built Different
The agent engine is deterministic code — not AI. AI is just one tool it orchestrates.
100% Local Data
Your data stays on your machine as plain Markdown files. You own everything. Always.
Any Editor
VS Code, Vim, Obsidian, Typora, Notepad — anything that can edit a .md file works.
Deterministic Routing
/translate(ja) Hello always routes to the translation skill. No LLM guessing.
Offline-First
Local commands work offline. Remote tasks queue automatically and execute when you're back online.
Infinitely Extensible
Add skills with YAML (zero code) or Python plugins. Hot-reload — no restart needed.
Git-Native Sync
Auto commit + push/pull. Multi-device sync and full version history for free.
Use Cases
One tool for everything text.
AI Writing Studio
Rewrite, expand, polish, summarize — all in your Markdown file.
Translation Desk
/translate(ja) Hello inline, or translate entire documents.
Coding Assistant
Attach to any project in assistant mode. Editor-agnostic.
Privacy-First AI
For those who refuse to hand data to cloud platforms.
Smart Notes
Supercharge Obsidian / VS Code with AI — without changing your workflow.
Research & Summaries
Read, summarize, translate — a complete research pipeline.
Learning Companion
Study notes + AI tutor, seamlessly integrated.
Mind Mapping
/canvas turns text into Obsidian Canvas mind maps.
How ChatMarkdown Compares
We occupy a unique position: local-first + deterministic.
| Dimension | Claude Code / Cursor | ChatGPT / Claude Web | ChatMarkdown |
|---|---|---|---|
| Core Brain | AI (LLM decides) | AI (LLM decides) | Deterministic Code |
| Data Location | Local (session temp) | Cloud | Local (Markdown + Git) |
| Interaction | Terminal (blocking) | Browser | Any editor (async) |
| Offline | ❌ No | ❌ No | ✅ Local skills work |
| Extensibility | Limited | Plugins (cloud) | YAML + Python (local) |
| Persistence | Session temporary | Cloud history | Git versioned forever |
40+ Built-in Commands
From date stamps to AI writing — all through slash commands.
⚡ AI Conversation
/ask What is quantum computing?
/translate(ja) Hello world
✍️ AI Writing
/rewrite improve this paragraph
/summary @above
/expand /polish /tag /title
🧠 Natural Language
@ai{translate this to French}
@ai{summarize the above}
📅 Date & Time
/date /datetime /timestamp
/week /weekday /progress
📋 Markdown Templates
/table(3x4) /code(python)
/todo /link /img /heading
🔧 Infrastructure
/sync /log /status /list
/new /upload /canvas
Quick Start
Up and running in 60 seconds.
# Install
pip install chatmd
# Initialize a workspace
chatmd init ~/my-workspace
# Start the agent
chatmd start
# Open chat.md in your favorite editor and type:
/ask What is ChatMarkdown?
# Save the file → agent responds in-place ✨
Works on Windows, macOS, and Linux · Python 3.10+
Code Is the Brain. AI Is Just a Tool.
Unlike AI-centric agents where LLMs decide everything, ChatMarkdown uses deterministic code as the routing engine. AI is called only for what it's good at — understanding and generating content.
User input
→ Agent Engine (deterministic code)
→ Exact routing
├─ Local Skill → execute directly
├─ AI Skill → LLM for analysis & generation
├─ Remote Skill → API call
└─ Composite → orchestrate
→ Result written back to your file
Open Source. MIT Licensed. Forever Free.
ChatMarkdown is built in the open. Star us on GitHub, report issues, contribute code, or build your own skills.