chat.md

An md file as a chat interface and editable history in one.

GitHub Stars

57

User Rating

Not Rated

Favorites

0

Views

384

Forks

8

Issues

5

Installation
Difficulty
Advanced
Estimated Time
20-45 minutes

Installation

1Install 'chat.md' from the VS Code marketplace
2Configure your API key(s):
- Command Palette → "Add or Edit API Configuration"
3Create a new chat:
- Opt+Cmd+' (Mac) / Ctrl+k Ctrl+c (Windows/Linux) to create a new '.chat.md' file with workspace information populated in a user block. - Or create any file with the .chat.md extension anywhere and open it in vscode.
4In a '# %% user' block write your query and press 'Shift + Enter' (or just create a new '# %% assistant' block and press enter)
5Watch the assistant stream its response and do any tool call.
Optionally you can start a markdown preview side by side to get live markdown preview of the chat which is more user friendly.
You can insert a # %% system block to append any new instructions to the system prompt.
You can manually add API configuration and MCP configuration in vscode settings. See [example settings](#example-vscode-settings)
Click on the live status bar "Chat.md streaming" icon in the bottom or run "chat.md: Cancel streaming" command to interrupt
You can also use the same shortcut "Opt+Cmd+'" to cancel streaming as for creating a new chat.
You can run command "Refresh MCP Tools" to reload all mcp servers. Then run "MCP Diagnostics" to see available mcp servers.
You can use "Select api configuration" command to switch between the API providers

Additional Resources