Blade Code

🗡️ Blade Code

新一代 AI 编程助手（CLI + Web UI）

[](https://www.npmjs.com/package/blade-code) [](LICENSE) [](https://nodejs.org/) [](CONTRIBUTING.md)

[English](README.en.md) | 简体中文

---

📸 界面预览

CLI 终端界面

Web UI 界面（0.2.0 新增）

---

✨ 核心特性

• 🤖 智能对话 - 上下文理解、多轮协作、可继续会话
• 🧠 自动记忆 - 跨会话持久化项目知识，自动学习构建命令、代码模式、调试洞察
• 🌐 双模式界面 - CLI 终端 + Web UI，随心切换
• 🛠️ 丰富工具 - 20+ 内置工具：文件/搜索/Shell/Git/Web 等
• 🔗 扩展能力 - MCP、插件与 Skills 系统
• 📋 结构化工作流 - Spec / Plan / Subagents
• 🔒 安全可控 - default/autoEdit/plan/yolo 权限模式与工具白/黑名单
• 🎨 现代 UI - React + Ink 终端 UI / React + Vite Web UI

---

🚀 快速开始

# 快速体验
npx blade-code

# 全局安装
npm install -g blade-code
# 或
pnpm add -g blade-code

# CLI 模式
blade
blade "帮我分析这个项目"
blade --print "写一个快排算法"
blade --headless "分析这个仓库并给出重构建议"
blade --headless --output-format jsonl "在 CI 中运行完整 agent 循环"

# Web UI 模式（0.2.0 新增）
blade web                    # 启动并打开浏览器
blade serve --port 3000      # 无头服务器模式

> 首次启动需配置模型，运行 blade 后输入 /model add 进入向导。

---

⚙️ 可选配置

配置文件支持全局和项目级：~/.blade/config.json 或 .blade/config.json。 更多配置项见文档。

{
  "provider": "openai-compatible",
  "apiKey": "${BLADE_API_KEY}",
  "baseUrl": "https://api.openai.com/v1",
  "model": "gpt-4o-mini"
}

---

🧰 命令速览

常用命令

• blade 启动交互式 CLI 界面
• blade web 启动 Web UI（0.2.0 新增）
• blade serve 启动无头服务器（0.2.0 新增）
• blade mcp 管理 MCP 服务器
• blade doctor 环境自检
• blade update 检查更新

常用选项

• --print/-p 打印模式（适合管道）
• --headless 无 Ink UI 的完整 agent 模式，按终端事件流输出
• --output-format 输出格式（text/json/stream-json/jsonl）
• --permission-mode 权限模式
• --resume/-r 恢复会话 / --session-id 指定会话

Headless 模式

• blade --headless "..." 会运行完整 agent loop，但不启动交互式 Ink UI
• 默认权限模式为 yolo，除非显式传入 --permission-mode
• --output-format jsonl 会输出稳定的机器可消费事件流，适合 CI、sandbox 和测试场景

交互式命令（会话内）

• /memory list 列出所有记忆文件
• /memory show 显示 MEMORY.md 内容
• /memory edit [topic] 用编辑器编辑记忆文件
• /memory clear 清空所有记忆

---

📖 文档

• 用户文档
• [本仓库文档入口](docs/README.md)
• [贡献指南](CONTRIBUTING.md)

---

🤝 贡献

git clone https://github.com/echoVic/blade-code.git
cd blade-code && bun install && bun run dev

---

💬 交流群

添加小助手微信 VIc-Forever，备注「Blade」拉你进群。

---

🔗 相关资源

• NPM 包
• Discord 社区 - 加入我们的 Discord 服务器
• 问题反馈

---

⭐ Star History

---

📄 许可证

[MIT](LICENSE) - Made with ❤️ by echoVic

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: echoVic
• Source: echoVic/blade-code
• License: MIT
• Homepage: https://echovic.github.io/blade-code/

Install and usage instructions live in the source repository linked above.