Neox

AI Code Assistant · CLI + Desktop

支持多模型 · 智能回滚 · Java 调试 · 内置终端与编辑器

---

Features

| 功能 | 说明 | 状态 |
|------|------|------|
| 多模型支持 | Claude / GPT / 豆包 / 自定义 API | ✅ |
| 双形态 | CLI 终端 + Electron 桌面应用 | ✅ |
| Shadow Git | 消息级自动快照，支持多级回滚 | ✅ |
| 内置编辑器 | Monaco Editor (VS Code 同款) | ✅ |
| 内置终端 | 多终端会话管理 | ✅ |
| Timeline | 可视化操作时间线 | ✅ |
| Java Debug | 基于 DAP 协议的调试集成 | ✅ |
| Python Debug | Python 调试支持 | 🚧 |
| 浏览器自动化 | Puppeteer 集成 | 🚧 |
| 插件系统 | 第三方工具扩展 | 📋 |
| 多 Agent 协作 | 多角色 Agent 并行工作 | 📋 |

> ✅ 已完成 · 🚧 开发中 · 📋 计划中

---

Quick Start

$3

``bash


安装（默认：轻量版，无需编译）

npm install -g @mk-co/neox-cli

启动

neox
`

需要 Electron UI？ 参见 Windows 安装指南

$3

从 Releases 下载对应平台安装包。

macOS 首次打开如遇安全提示：
`bash
sudo xattr -r -d com.apple.quarantine /Applications/Neox.app
`

$3

`bash
git clone https://github.com/mk-co/Neox.git
cd Neox && npm install

CLI

npm run dev

Desktop

npm run ui:dev
`

---

Configuration

首次启动会引导配置，配置文件位置：

| 平台 | 路径 |
|------|------|
| macOS | ~/Library/Application Support/Neox/config.json |
| Linux | ~/.config/neox/config.json |
| Windows | %APPDATA%\Neox\config.json |

配置示例：

`json
{
"providers": [
{
"id": "openai",
"type": "openai",
"baseUrl": "https://api.openai.com/v1",
"apiKey": "sk-...",
"models": ["gpt-4o"]
}
]
}
`

---

CLI Commands

`bash


会话

/sessions # 列出会话
/session new # 新建会话
/clear # 清空当前会话

回滚

/checkpoint [name] # 创建检查点
/rollback # 打开快照选择器
/undo # 撤销上一步

模型

/provider list # 查看 Provider
/model # 切换模型
/health # 健康检查
`

---

Java Debug

`bash


安装调试组件

npm run setup-java-debug

启动 Java 应用 (开启调试)

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar app.jar
`

然后在 Neox 中连接 localhost:5005 即可让 AI 进行断点调试。

---

Tech Stack

- Runtime: Node.js 20+
- Desktop: Electron 32
- Editor: Monaco Editor
- Terminal: xterm.js + node-pty
- AI SDK: OpenAI API / Anthropic API

---

Contributing

`bash


Fork & Clone

git checkout -b feature/xxx

提交

git commit -m "feat: xxx"

PR

``

---

License

MIT

---

_{Built by MK-CO}