chat.md
by rusiaaman·★ 105·Score 47
A VS Code extension that turns .chat.md files into editable AI chat interfaces with MCP support.
Overview
chat.md is a Visual Studio Code extension that reimagines AI interaction through plain text files with .chat.md extension. Unlike ephemeral web interfaces, chat.md treats conversations as files that can be edited, version controlled, and shared. The extension supports multiple AI providers (Anthropic Claude, OpenAI, custom APIs) and implements MCP as a client to enable tool calling with any LLM. It features non-linear editing, file attachments, conversation templates, and Git-friendly tracking.
Try asking AI
After installing, here are 6 things you can ask your AI assistant:
When to choose this
Choose this when you want editable, version-controlled AI conversations stored as regular files in your workspace, especially if you work with multiple LLM providers.
When NOT to choose this
Don't choose this if you need real-time voice conversations or if you prefer web-based AI interfaces over file-based solutions.
Tools this server exposes
1 tool extracted from the READMEfilesystem.searchFilesSearch for files matching a pattern in a directory
Note: Only one tool example was explicitly shown in the README, though MCP integration is mentioned as a core feature. The actual tool names would depend on which MCP servers are configured by the user.
Comparable tools
Installation
Installation
- Install 'chat.md' from the VS Code marketplace
- Configure your API key(s):
- Command Palette → "Add or Edit API Configuration"
- Create a new chat file:
- Opt+Cmd+' (Mac) / Ctrl+k Ctrl+c (Windows/Linux) to create a new '.chat.md' file - Or create any file with the .chat.md extension and open it in VS Code
MCP Configuration
Add MCP servers to your VS Code settings.json:
"chatmd.mcpServers": {
"wcgw": {
"command": "uvx",
"args": [
"--python",
"3.12",
"--from",
"wcgw@latest",
"wcgw_mcp"
]
}
}FAQ
- Which AI models does chat.md support?
- chat.md supports Anthropic Claude (all models), OpenAI (GPT-4, GPT-3.5), and any OpenAI-compatible endpoint (Azure, Google Gemini, etc.).
- Can I edit AI responses?
- Yes, chat.md files are fully editable. You can rewrite history, edit AI responses, and have the AI continue from any edited point.
- How does MCP integration work?
- chat.md acts as an MCP client, connecting to both local and remote MCP servers via stdio or streamable HTTP/SSE transports. It automatically discovers and executes tools from any MCP server.
On Hacker News
Recent discussion from the developer community.
- Story by Bogdanp · 2025-08-25
- Story by pcwelder · 2025-04-10
- Story by pcwelder · 2025-04-14
Compare chat.md with
Last updated · Auto-generated from public README + GitHub signals.