Kun
by KunAgent
Local-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.
5,567stars
543forks
TypeScript
Added 8/2/2026
View on GitHubDownload ZIPScan for vulnerabilities
Requires a passing catalog security scan. Resolve the flagged issues and resubmit to enable featuring.
AI Agentsagentic-workflowai-agentai-assistantai-designautomationcoding-agentdeepseekdesktop-appelectronllmlocal-firstmcpmulti-agentopenai-compatibleproductivityreacttuitypescriptwriting-assistant
Installation
# Add to your Claude Code skills
git clone https://github.com/KunAgent/KunGetting Started
Guides for using ai agents skills like Kun.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportWarning
Last scanned: 8/2/2026
{
"issues": [
{
"type": "npm-audit",
"message": "@computer-use/default-clipboard-provider: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@computer-use/libnut: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@computer-use/nut-js: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@computer-use/provider-interfaces: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@computer-use/shared: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@jimp/core: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@jimp/custom: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "brace-expansion: brace-expansion: DoS via exponential-time expansion of consecutive non-expanding {} groups",
"severity": "high"
},
{
"type": "npm-audit",
"message": "file-type: file-type affected by infinite loop in ASF parser on malformed input with zero-size sub-header",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "jimp: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "postcss: PostCSS: Path Traversal in Previous Source Map Auto-Loading (sourceMappingURL) leads to Arbitrary .map File Disclosure",
"severity": "high"
}
],
"status": "WARNING",
"scannedAt": "2026-08-02T06:31:26.547Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}Kun 是什么
Kun 是一个本地优先的 AI Agent 工作台，同时提供桌面 GUI 和终端 TUI。两种界面连接同一个 kun serve 运行时，共享线程、模型连接、审批、计划、子代理、用量和后台任务；你可以在桌面里看清完整过程，也可以在终端里保持手不离键盘。
Kun 的重点不是再做一个聊天框，而是把一次真实工作从输入推进到可以验收的结果：
需求澄清 → 设计 → 计划 → 编码 / 执行 → 审查 → 验收
- 需求先行：先明确目标、边界和验收标准，再让 Agent 执行。
- 一个运行时，两种界面：GUI 与 TUI 可以同时使用，切换界面不丢线程和后台任务。
- Agent Graph：把可拆分的复杂任务组织成依赖图，由 Lead Agent 派发、监督、返工和汇总。
- 证据化交付：文件 Diff、命令结果、测试、浏览器和审查结果都留在任务旁边，不把“Agent 说完成了”当作完成。
- 不绑定单一模型：统一管理订阅登录、Coding Plan、Token Plan、API Key、兼容服务和自托管模型。
5 分钟开始
下载桌面版
从 GitHub Releases 下载最新版：
| 平台 | 安装包 | 架构 |
|---|---|---|
| macOS | .dmg / .zip |
Apple Silicon / Intel |
| Windows | .exe |
x64 |
| Linux | .AppImage / .deb |
x64 |
首次启动只需：
- 选择界面语言。
- 登录模型订阅，或配置一个 API Key / Token Plan / 自定义 Provider。
- 在 Code 中打开本地项目，然后发送一个目标清楚、范围有限、可以验证的任务。
桌面安装包已内置 TUI。打开新终端，在项目目录运行：
kun
GUI 和 TUI 会自动连接同一个本地运行时。服务器或无桌面环境也可以从同一 Release 下载独立 TUI 压缩包。完整说明见 Kun TUI 文档。
选择你的工作方式
| 入口 | 适合做什么 | 主要产物 |
|---|---|---|
| Code | 理解真实代码库、编辑文件、执行命令、管理计划和审查改动 | 代码 Diff、测试结果、实施计划、Review findings |
| Design | 从需求或现有界面探索视觉方向，生成并迭代交互原型 | HTML 原型、设计画布、设计流程、DESIGN_SYSTEM.md |
| Write | 写作、润色、研究资料、导出文档或生成演示文稿 | Markdown、HTML、PDF、DOCX、可编辑 PPTX |
| TUI | 在终端里管理会话、模型、计划、审批、Skills、MCP 和子代理 | 与 GUI 共享的线程、回合和任务结果 |
| 连接手机 | 从飞书 / Lark / 微信或 webhook 触发和继续任务 | IM 会话、后台任务、通知 |
Code、Design 和 Write 不是三套孤立工具。Design 可以把确认后的设计交给 Code 实现，Write 可以沉淀需求和交付文档，它们都复用相同的运行时、Provider、审批和会话能力。
从需求到验收
| 阶段 | Kun 如何参与 |
|---|---|
| 1. 澄清需求 | 新建需求草稿，让需求 AI 结合项目内容补问题、整理边界和验收标准 |
| 2. 探索设计 | 在 Design 中把需求变成 UI 方向、交互原型或共享设计系统 |
| 3. 形成计划 | 使用 /plan 把目标拆成可执行步骤，并与需求和 Todo 对齐 |
| 4. 执行任务 | Agent 搜索代码、修改文件、调用工具、运行命令；长任务可持续恢复 |
| 5. 回到验收 | 检查 Diff、测试和 /review findings，对照原始验收标准确认结果 |
需求文档和计划默认保存在项目内，便于版本化、复盘和继续工作。需求变化时，应重新检查计划和已经完成的步骤，而不是让旧计划继续静默执行。
Agent Graph：让复杂任务真正分工
实验性的 Graph 模式适合跨文件、跨阶段、可以明确验收的复杂任务。Lead Agent 会先建立任务依赖图，再按依赖派发受限子代理，持续查看执行过程、要求补充证据、触发返工，并在所有必要节点通过后统一交付。
Graph 不是第二套运行时，也不会扩大权限：
- GUI 和 TUI 都通过同一个 Kun 运行时读取 Graph 状态。
- 子代理只能使用父任务授权范围内的文件、工具、网络、Skills 和 MCP。
- 节点只有经过真实校验和 Lead 明确验收后，才能向下游交接结果。
- 可暂停、恢复、重试、修改任务图或停止；已发生的执行记录不会被伪装成成功。
简单问答和单点修改使用 Direct 模式更快。Graph 的使用和限制见 Graph Mode 文档。
关键能力
| 能力 | 说明 |
|---|---|
| 真实项目工作台 | 本地工作区、文件搜索与编辑、Terminal、Browser、Git / Worktree、内联 Diff 和 Changes 面板 |
| 长任务与上下文 | Plan、Todo、持久目标、会话压缩、分叉、归档、旁支问题、后台 Shell 和子代理 |
| 模型与额度 | 统一管理订阅、API 和套餐连接；切换 Provider / 模型 / 推理强度，并查看支持供应商的额度信息 |
| Agent 与知识 | Agent Profile、长期记忆、项目级 AGENTS.md、Skills、MCP 和 Extensions |
| 自动化 | 一次性或周期性 Schedule、可视化 Loop 工作流、Hook 和本地运行 API |
| 多模态与媒体 | 图片和 PDF 输入、视觉理解、语音转写、图片、语音、音乐和视频生成 |
| 开放扩展平台 | 安装或侧载 .kunx，扩展工作台 UI、后台服务、Agent、工具、Provider 和账号接入 |
| 权限与审查 | 工作区范围、Sandbox、工具审批、Computer Use 权限、敏感操作确认和 /review |
模型、媒体和高权限能力是否可用，取决于当前版本、操作系统、Provider、模型能力和你的授权。预设是配置起点，不代表账号天然拥有对应模型或额度。
订阅、Provider 与模型
Kun 把订阅登录、套餐 Key 和普通 API 放进同一个 Provider 入口：
| 类型 | 当前支持 |
|---|---|
| 账号订阅 | ChatGPT / Codex、Claude Pro / Max、Google Antigravity、Gemini CLI、Cursor、Ollama Cloud、Grok |
| Coding Plan | 智谱 Coding Plan、Z.ai Coding Plan、火山方舟 Agent Plan、火山方舟 Coding Plan、Kimi coding subscription |
| Token Plan | Xiaomi MiMo、MiniMax、阿里云、腾讯云的 Token Plan 入口 |
| 兼容与自托管 | OpenCode Go、Vercel AI Gateway、LiteLLM、LongCat、OpenAI-compatible 和自托管模型 |
具体登录方式、可用模型、地区和额度以当前版本及服务商规则为准；预设是配置起点，不保证账号已经开通对应权限。
会话、偏好、日志和运行时数据默认保存在本机；模型请求使用你配置的服务凭据。退出 GUI 不会终止仍在 TUI 或后台执行的任务，退出 TUI 也不会关闭桌面端。本地优先不等于模型一定在本机推理：除非连接自托管模型，否则提示、附件和任务上下文会发送给所选 Provider。
Kun 把不同接入方式放进同一个模型入口：
- 支持的订阅登录和 Agent SDK；
- Coding Plan、Token Plan 与按量 API；
- OpenAI Chat Completions、Responses、Anthropic Messages 等兼容协议；
- 自定义 Base URL、模型列表、能力声明和自托管服务；
- 为默认 Agent、特定线程、Design、Write、Schedule 或子代理选择不同模型；内置预设还包括 DeepSeek、Xiaomi MiMo、MiniMax、Kimi、GLM、Qwen 等服务。
从源码运行
环境要求：
| 依赖 | 版本 |
|---|---|
| Node.js | 22.19+ |
| npm | 随 Node.js 安装 |
| 模型连接 | 至少配置一个受支持的订阅、API 或自定义 Provider |
git clone https://github.com/KunAgent/Kun.git
cd Kun
npm install
npm run dev
单独启动开发版 TUI：
npm run dev:tui
中国大陆网络访问较慢时，可以使用 npm 镜像：
npm install --registry=https://registry.npmmirror.com
常用开发命令
| 命令 | 说明 |
|---|---|
npm run dev |
构建 Kun 运行时并启动 Electron 开发环境 |
npm run dev:tui |
构建运行时并启动终端 TUI |
npm run typecheck |
TypeScript 类型检查 |
npm run lint |
ESLint 检查 |
npm run test |
运行测试 |
npm run build |
生产构建 |
npm run dist:mac |
构建 macOS 安装包 |
npm run dist:win |
构建 Windows 安装包 |
npm run dist:linux |
构建 Linux 安装包 |
文档
面向用户的完整文档位于 kun-agent.com/docs。仓库中的技术文档适合开发者和贡献者：
| 文档 | 内容 |
|---|---|
| docs/kun-tui.md | TUI 安装、启动、命令、快捷键、配置和运行时 |
| docs/graph-mode.md | Graph 架构、调度、监督、权限和恢复 |
| docs/kun-architecture.md | GUI、TUI 与单运行时架构 |
| docs/DESIGN_MODE.md | Design 画布、原型、设计系统与 Design → Code |
| docs/workflow-loop.md | 可视化 Loop 工作流 |
| docs/project-mcp-skills.md | 项目级配置、MCP 与 Skill 发现 |
| docs/extensions/README.md | Kun Extension 开放平台 |
| kun/README.zh-CN.md | Kun 运行时、CLI、环境变量和 HTTP API |
| docs/DEVELOPMENT.zh-CN.md | 本地开发和发布流程 |
| docs/CONTRIBUTING.zh-CN.md | 贡献指南 |
| SECURITY.zh-CN.md | 安全漏洞披露 |
贡献
欢迎提交 bug 修复、UI/UX、运行时、Provider、扩展和文档改进。日常集成分支为 develop，PR 默认提交到 develop；开始前请阅读贡献指南，外部贡献需要接受 Contributor License Agreement。
累计有 5 个 PR 被正常 review 并合入 后，可以发送邮件到 zhongxingyuemail@gmail.com 申请成为 Kun Builder，并附上 GitHub 用户名和 PR 链接。
许可证
Kun 使用 PolyForm Noncommercial License 1.0.0，仅供学习、研究和非商业用途。商业使用、商业分发、SaaS / 托管服务、转售或集成到商业产品中，需要获得作者的单独书面授权。
企业仅用于内部员工提效时，可发送邮件到 zhongxingyuemail@gmail.com 免费申请书面内部使用授权。该授权不包含面向外部客户的 SaaS、托管、转售或商业分发。
致谢
感谢 LobsterAI、DeepSeek、Xiaomi MiMo、MiniMax，以及所有提交 issue、建议、代码和文档的贡献者。
Star 历史
Frequently Asked Questions
What is Kun?
Kun is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by KunAgent. Local-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI. It has 5,567 GitHub stars.
Is Kun safe to use?
Kun returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.
How do I install Kun?
Clone the repository with "git clone https://github.com/KunAgent/Kun" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is Kun written in?
Kun is primarily written in TypeScript. It is open-source under KunAgent on GitHub, so you can review or fork the full source.
Are there alternatives to Kun?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Kun against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
236,865
36,014
JavaScript
AI Agentsai-agentsanthropic
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
199,005
59,844
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
123,338
8,346
Rust
AI Agentsai-toolsclaude-code