# Blade Code

> AI-powered CLI coding agent with 20+ built-in tools, MCP support, and multi-model providers

- **Type:** MCP server
- **Install:** `agentstack add mcp-echovic-blade-code`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [echoVic](https://agentstack.voostack.com/s/echovic)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [echoVic](https://github.com/echoVic)
- **Source:** https://github.com/echoVic/blade-code
- **Website:** https://echovic.github.io/blade-code/

## Install

```sh
agentstack add mcp-echovic-blade-code
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🗡️ 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

---

## 🚀 快速开始

```bash
# 快速体验
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`。
更多配置项见文档。

```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` 清空所有记忆

---

## 📖 文档

- **[用户文档](https://echovic.github.io/blade-doc/#/)**
- **[本仓库文档入口](docs/README.md)**
- **[贡献指南](CONTRIBUTING.md)**

---

## 🤝 贡献

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

---

## 💬 交流群

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

---

## 🔗 相关资源

- [NPM 包](https://www.npmjs.com/package/blade-code)
- [Discord 社区](https://discord.gg/utXDVcv6) - 加入我们的 Discord 服务器
- [问题反馈](https://github.com/echoVic/blade-code/issues)

---

## ⭐ Star History

 
   
   
   
 

---

## 📄 许可证

[MIT](LICENSE) - Made with ❤️ by [echoVic](https://github.com/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](https://github.com/echoVic)
- **Source:** [echoVic/blade-code](https://github.com/echoVic/blade-code)
- **License:** MIT
- **Homepage:** https://echovic.github.io/blade-code/

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-echovic-blade-code
- Seller: https://agentstack.voostack.com/s/echovic
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.