gpt-runner
Conversations with your files! Manage and run your AI presets!
Links
README
From the repo.
GPT Runner
English / 简体中文 🌏
Use GPT-Runner to manage your AI presets, engage in AI-powered conversations with your code, and significantly boost the development efficiency of both you and your team!
用 GPT-Runner 管理您的 AI 预设,通过 AI 与您的代码文件聊天,极大提升您和团队的开发效率!
CLI / Web Page / VSCode Extension / Issues / Buy Me a Coffee
📚 Table of Contents
- 🤷♂️ Why GPT-Runner?
- ⚙️ Features
- 🚀 Quick Start
- 📖 Documentation
- 🗒️ Road map
- 🆕 What's New
- ❓ FAQ
- 💖 Sponsor
- 🤝 Contributor
- 🙏 Acknowledgement
- 📜 LICENSE
🤷♂️ Why GPT-Runner?
-
🔍 Conversations with Code Files:
- Before using GPT-Runner: Manual copy and paste of multiple file codes into the ChatGPT window were required to propose features or fix bugs to AI.🙁
- After using GPT-Runner: Simply select your project files from the file tree. The AI will provide responses based on the most recent contents of those files.🤩
-
📑 Manage the Project's AI Presets:
- Before using GPT-Runner: Project prompts saved in memos needed to be copied and pasted to ChatGPT for inquiries, making it difficult to put them under git version control.🤪
- After using GPT-Runner: Each xxx.gpt.md file represents an AI role preset. They are easy to read, modify, and can be version-controlled. Team members can share and enhance AI presets, making the code they produce closer to 100% usability.🥰
⚙️ Features
- 🔍 Conversations with Code Files: Select files or folders and engage in real-time conversations with AI.
- 🛠️ Powerful CLI and IDE integration: Implement efficient AI workflows in various IDEs.
- 🔖 AI Preset Manager: Manage your AI presets, Just like a locally Storybook for AI presets.
- 🤖 Customize AI parameters: Flexibly control the configuration of AI models.
- 🔌 Support for third-party LLMs: High compatibility and adaptability.
- 🔒 Privacy-first: Local data storage protects your privacy.
- 🌎 Locale support: Support for multiple languages.
🚀 Quick Start
Make sure you have an Open AI Key or a Anthropic Key. You can get it from Open AI or Anthropic.
The first way: CLI
- Requirements NodeJS >= 16.15.0
- To check your NodeJS version, run
node -vin your terminal. If you need to install or update NodeJS, visit the official NodeJS website for download and installation instructions.- First run the following command to download this package, which will take a long time, which is normal.
cd <your project folder>
npx gptr
You can see the web interface in your browser at http://localhost:3003.
The second way: VSCode Extension
Requirements VSCode >= 1.78.0
Install the GPT-Runner VSCode Extension from the VSCode Marketplace.
📖 Documentation
GPT-Runner Configs And AI Preset Files
For details about gptr.config.json configuration file, xxx.gpt.md AI preset file, .gpt-runner special directory, please refer to here:
Introduction to GPT-Runner Configs And AI Preset Files
GPT-Runner Ui Usage
Introduction to GPT-Runner Ui Usage
🗒️ Road map
- Jetbrains Plugin: Add Jetbrains IDE Plugin
- Export And Import Chat History: Add dialogue import and export function
- AI Preset Store: Add AI Preset Store for community sharing AI Preset File
- Template Interpolation: Add template interpolation support
- Electron: Add an Electron client to expand the target audience to non-developers
🆕 What's New
- 🚀 v1.0.0: First Release
❓ FAQ
You can contact me via 2214962083@qq.com
对 AI 提升开发效率感兴趣的,可以加我 wechat: qq2214962083 入群交流
要求:会科学上网,使用过 chatgpt
💖 Sponsor
Waiting for you...
🤝 Contributor
You can check out our Contribution Guidelines
This project exists thanks to all the people who contribute:
🙏 Acknowledgement
GPT-Runner is made possible thanks to the inspirations from the following projects:
in alphabet order
- Docusaurus
- Gradio
- LangchainJs
- Monaco-React
- UnoCss
- VSCode-Material-Icon-Theme
- VSCode-Webview-Ui-Toolkit
📜 LICENSE
MIT License © 2023-PRESENT Jinming Yang
Collected info
- ★ 381 stars
- ⎇ 46 forks
- Language: TypeScript
- Source updated: 6/11/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.