返回项目目录
KunAgent

KunAgent

Kun

Local-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.

MCPAgent模型 / 推理AI 编程工作流 / 自动化agentic-workflowai-agentai-assistantai-designautomationcoding-agent
Stars
6124
Forks
582
Watchers
6124
Issues
7

README

项目介绍

8132 bytes

Kun 蓝色 K 标识

Kun — 本地优先的 AI Agent 工作台

让 AI 在真实项目中规划、执行、验证并交付。
桌面 GUI 与终端 TUI 共用同一个本地运行时,任务、审批、计划和证据始终连续。

下载桌面版  ·  阅读文档  ·  GitHub  ·  English

Kun 最新 GitHub Release Kun 使用 PolyForm Noncommercial 1.0.0 许可证 支持 macOS、Windows 和 Linux 桌面 GUI 与终端 TUI 共用一个 Kun 运行时

Kun GUI 与 TUI 海报:虚构演示数据中的吉祥物、桌面 Code 界面与终端 TUI

Kun 是什么

Kun 是把 AI 从“回答问题”推进到“完成工作”的本地优先工作台。它以两个主模式组织真实工作:Code 面向软件交付,并在同一任务中提供 Design 画布;Work 面向写作、资料整理、文档分析和演示产出。Agent 可以读取工作区上下文、制定计划、调用工具、修改文件、运行验证,并把证据留在任务旁。

桌面 GUI 适合观察、审阅和控制过程;终端 TUI 适合专注于键盘工作。两者通过同一个本地 kun serve 运行时共享线程、目标、计划、审批和后台任务,而不是两套彼此割裂的会话。

一眼了解

你需要 Kun 提供
构建、调试与发布软件 Code 模式提供项目上下文、文件编辑、终端、Git / Worktree、Diff、测试和审查。
从需求走到可实现的设计 在同一 Code 任务中切换 Design 画布,沉淀原型、设计系统和 Design → Code 上下文。
写作、整理与处理日常任务 Work 模式可编辑 Markdown,预览、引用和分析 PDF / Office 文档,分析电子表格,并从大纲创建演示文稿;Office 文件保持只读。
自动化重复流程 Scheduled tasks、Loops、Hooks、MCP、Skills 与可安装扩展。
选择模型和接入方式 订阅、计划、API、OpenAI / Anthropic 兼容服务与自托管模型均可通过 Provider 配置接入。

当前界面

以下截图均通过浏览器自动化在一次性隔离的应用配置和演示工作区中重新采集。截图内没有真实项目、账户信息、个人设置或会话记录。

Code:构建、调试与发布

Code 模式把项目、分支、Code / Design 任务入口和任务输入区放在同一工作台中。它适合阅读和修改代码、运行终端与测试、检查 Diff,以及在需要时进入 Design 画布继续完成方案。

Code 模式概览:演示项目、Code 和 Design 任务入口、分支与任务输入区

Work:写作、整理与日常任务

Work 模式用工作区文件树、任务启动器和 Work assistant 组织文档工作。可以起草 Markdown、总结或询问文档、分析电子表格、创建演示文稿,也可以用白板梳理想法。

Work 模式概览:演示文件树、文档任务启动器和 Work assistant

从目标到验收

澄清目标 → 形成计划 → 执行与协作 → 检查证据 → 交付或继续
  1. 给出目标和约束。 Agent 结合项目内容补足范围、风险和验收标准。
  2. 按计划逐步执行。 根据任务范围推进文件修改、工具调用和验证;需求变化时及时调整计划。
  3. 在可见的上下文中执行。 计划、Todo、工具调用、文件改动、浏览器/终端结果和审批都关联到任务。
  4. 以证据完成交付。 回看 Diff、测试、审查和产物;需求变化后可以继续、分叉、归档或重新规划。

需求和计划默认可以保存在项目中,因此能进入版本控制、代码审查和后续恢复流程。

本地优先,不等于永不联网

会话、偏好、日志和运行时数据默认保存在本机。选择云端模型后,提示、附件和任务上下文会发送给所选 Provider;使用前请确认该服务的数据政策。工具权限、敏感操作和扩展权限会在界面中明确呈现,仍由你决定是否授权。

Kun 不绑定单一模型。预设覆盖 ChatGPT / Codex、Claude、Gemini、Cursor、Ollama、DeepSeek、Kimi、GLM、Qwen、MiniMax 和 Xiaomi MiMo 等生态;登录方式、模型、地区与额度取决于当前版本和 Provider 规则。请查看 模型 Provider 文档 了解配置方式。

5 分钟开始

GitHub Releases 下载当前版本:

平台 安装包 架构
macOS .dmg / .zip Apple Silicon / Intel
Windows .exe x64
Linux .AppImage / .deb x64

启动后:

  1. 选择语言并配置一个模型订阅、计划、API 或自定义 Provider。
  2. 打开本地项目或创建工作区。
  3. 发送一个目标明确、范围有限、可以验证的任务。

桌面版和 TUI 可同时连接同一个运行时。在项目目录中运行:

kun

也可从 Release 下载独立 TUI;更多命令和配置见 Kun TUI 文档

从源码运行

要求:Node.js 22.19+、npm,以及至少一个可用的模型连接。

git clone https://github.com/KunAgent/Kun.git
cd Kun
npm ci
npm run dev
命令 用途
npm run dev 构建运行时并启动 Electron 开发环境
npm run dev:tui 构建运行时并启动终端 TUI
npm run typecheck TypeScript 类型检查
npm run lint 运行 ESLint 与文件大小检查
npm run test 运行测试
npm run build 生产构建
npm run dist:mac / dist:win / dist:linux 构建对应平台安装包

中国大陆网络访问较慢时可使用 npm 镜像:

npm ci --registry=https://registry.npmmirror.com

文档与贡献

主题 文档
TUI、命令和运行时 docs/kun-tui.md / kun/README.zh-CN.md
Design 工作流 docs/DESIGN_MODE.md
Loops、MCP 与 Skills docs/workflow-loop.md / docs/project-mcp-skills.md
Extension 平台 docs/extensions/README.md
本地开发 docs/DEVELOPMENT.zh-CN.md

欢迎贡献 bug 修复、UI/UX、运行时、Provider、扩展和文档。日常集成分支为 develop,PR 请以 develop 为目标分支;开始前阅读 贡献指南,外部贡献需要接受 CLA

许可证

Kun 使用 PolyForm Noncommercial License 1.0.0,仅供学习、研究和非商业用途。商业使用、商业分发、SaaS / 托管服务、转售或集成到商业产品中,需要获得作者的单独书面授权。

致谢

感谢所有提交 issue、建议、代码和文档的贡献者。

Kun contributors