Maintainer of this skill?
Automated security scan — not a certification.
by TheSyart
Local Emperor-style AI agent with Vue WebUI, multi-provider LLMs, streaming chat, tools, skills, memory, and token telemetry.
# Add to your Claude Code skills
git clone https://github.com/TheSyart/emperor-agentGuides for using ai agents skills like emperor-agent.
Last scanned: 6/18/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-18T08:49:11.373Z",
"npmAuditRan": true,
"pipAuditRan": false,
"promptInjectionRan": true
}See how emperor-agent compares with popular alternatives.
emperor-agent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by TheSyart. Local Emperor-style AI agent with Vue WebUI, multi-provider LLMs, streaming chat, tools, skills, memory, and token telemetry. It has 212 GitHub stars.
Yes. emperor-agent passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/TheSyart/emperor-agent" and add it to your Claude Code skills directory (see the Installation section above).
emperor-agent is primarily written in TypeScript. It is open-source under TheSyart on GitHub, so you can review or fork the full source.
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 emperor-agent against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
Emperor Agent 是一款面向个人长期使用的桌面 Agent。你可以用它处理日常问答，也可以绑定本地项目，让 Agent 在明确的权限范围内读取文件、运行工具并持续推进任务。
Emperor Agent 里有几组名称看起来相似，实际处在不同层级：
| 层级 | 含义 |
|---|---|
| Chat / Build | 会话类型：一个用于普通对话，一个绑定本地项目 |
| 权限预设 | read-only、workspace-write、danger-full-access：决定 Agent 能写哪里 |
| 计划 | 计划模式：先只读探索并提交方案，批准后再执行 |
| 目标 | 让 Agent 在你不再输入时一轮轮继续推进同一件事 |
| 定时任务 | 按时间触发一轮 Agent 对话 |
| 子智能体 | 主会话交出去的子任务的执行者：本地子智能体，或你电脑上的 Claude Code、Codex |
应用会把会话、记忆、配置和附件保存在本机。Chat（普通对话）适合问答和轻量任务；Build（项目工作）绑定本地目录，并读取项目中的 AGENTS.md / CLAUDE.md。
每个会话都完整记录在本机；应用崩溃后，会话可以自动修复并继续使用。
对话里的网页、GitHub 对象和文件使用类型图标、行内引用与摘要卡片。环境信息卡汇集「输出」和「来源」，列表里每一项可查看详情并定位原消息；网页详情按需加载；文件名统一在右侧文件面板预览，图片缩略图支持灯箱缩放、拖动与旋转。使用方式见资源链接与详情。
“本地优先”不等于完全离线。模型请求会发送给你配置的 Provider；调用远程 MCP、会联网的 Skill 或命令时，对应内容也会离开本机。
安装包适合直接使用，不要求目标机预装 Node.js、Python、Git 或 ripgrep。只支持 macOS，Windows 与 Linux 不受支持。
Emperor-Agent-<版本>-macos-arm64.dmg，Intel 芯片的 Mac 选 -macos-x64.dmg（也有同名的 .zip）。Emperor 会检查 GitHub 上的新版本，替你下载并核对 DMG（「设置 › 常规 › 更新」可以关闭），替换旧版本由你来做。每个新版本的代码身份都会变：更新后，电脑操作要在「设置 › 电脑操作」重新允许辅助功能与屏幕录制，听写要在「设置 › 语音」重新允许麦克风与语音识别。完整步骤见首次使用。
「设置 › 模型」按供应商分组保存多个模型：添加时 Emperor 先测试连接、读取厂商的模型列表，再按厂商接口与内置目录预填上下文、每次输出和思考强度；API Key 加密保存。当前使用哪个模型在聊天输入框中选择，切换从下一次请求开始生效。Provider 为 deepseek 时使用内置的 DeepSeek 适配器（官方地址默认走 Anthropic Messages），其他 Provider 按所选协议走 OpenAI Chat Completions 或 Anthropic Messages。可重试的错误最多自动重试 5 次，不会暗中切换模型；备用模型和每个任务的费用上限需要你在设置里打开。熟悉配置文件的用户也可以参考 config/examples/model_config.example.json。
模型配置、记忆和附件见模型、记忆与附件。
Chat 适合日常问答、资料整理和一次性的工具任务。它使用用户档案、全局长期记忆和当前会话历史，工作目录是 Emperor Home 下的 workspace/，不绑定你的项目。
Build 会话绑定一个本地文件夹，适合代码、文档和其他项目任务。Agent 会读取项目中逐级的 AGENTS.md / CLAUDE.md 和该项目的私有记忆。项目私有记忆保存在全局 stateRoot，不会写回项目文件。
| 命令 | 行为 |
|---|---|
/permissions read-only |
可以读取；任何写入都需要你逐次批准 |
/permissions workspace-write |
默认。可以写当前 workspace 和临时目录；超出范围时逐次请求批准 |
/permissions danger-full-access |
不限制写入，也不弹出审批 |
新会话从哪个预设开始可以在「设置 › 常规 › 会话 › 新会话的权限」更改。批准只对那一次工具调用有效。Shell 命令由 macOS 系统沙箱（Seatbelt）执行。受限预设主要限制文件写入；任何预设下 Agent 都读不到 Emperor 的电脑操作状态、浏览器数据和配置文件，并阻止部分系统 GUI 连接。普通文件读取和互联网访问仍不受此文件沙箱普遍限制。MCP stdio server 和插件 Hook 跑在同一套进程沙箱里，但读取默认关闭，只开放系统与工具链目录、workspace 和各自需要的目录；沙箱不可用时插件的进程不启动，你自己的 MCP server 先问你一次。工作流脚本在一个读不到项目文件、不能联网的独立进程里运行。
/plan
/plan 为现有项目设计一套迁移方案
/plan off
进入计划模式后，Agent 先只读探索、必要时向你提问，然后提交一份完整计划。你可以选择「批准并执行」（退出计划模式并开始执行）或「继续规划」（附上意见让它修改）。计划模式主要通过提示词约束 Agent，实际写入范围仍由当前权限预设决定。
/goal 让项目的全部测试通过
设置目标后，每当 Agent 空闲，系统会自动发起新一轮续跑，直到 Agent 判断目标完成、报告受阻，或达到轮数上限（默认 256 轮）。你的消息始终优先；按停止会把目标转为「已暂停」。
| 命令 | 作用 |
|---|---|
/goal |
查看当前目标 |
/goal <目标> |
设置目标 |
/goal edit <目标> |
修改目标 |
/goal pause |
暂停自动续跑 |
/goal resume |
恢复自动续跑 |
/goal clear |
清除当前目标 |
应用重启后目标保留，但需要 /goal resume 才会继续续跑。目标不提高权限。
主会话的 Agent 可以把独立的子任务交给子智能体，自己继续统筹。本地子智能体始终可用，也可以固定用一条便宜些的模型；你电脑上的 Claude Code 和 Codex 默认关闭，在「设置 › 子智能体」打开，第一次交给它们时会先问你。它们改文件时在独立的工作区里改，完成后会话里出现成果卡，看过差异再「应用到项目」，应用后可以撤销。点子智能体可以打开它的页面，直接给它发消息或回答它的问题。详见子智能体。
| 情况 | 使用 |
|---|---|
| 问答、轻量修改、明确的一次性任务 | 普通 Chat / Build |
| 希望先审阅方案 | 计划 |
| 希望 Agent 自己一轮轮推进到完成 | 目标 |
| 希望按时间定期发起任务 | 定时任务 |
| 命令 | 作用 |
|---|---|
/new |
在当前工作区创建一条空白会话 |
/compact |
保留摘要并释放当前会话的上下文空间 |
/model、/reasoning |
选择模型和思考强度 |
/permissions <预设> |
查看或切换权限预设 |
/plan、/goal |
进入计划模式或设置目标 |
/stop、/continue |
停止当前任务，或让 Agent 继续上一项工作 |
每个已启用的 Skill 直接使用自己的 token，例如 /agent-reach 搜索相关讨论。未知命令只在本地报错，不会发送给模型。完整语义见 Slash command 平台。
下面的分级描述当前版本的能力边界：「可直接使用」是日常可依赖的主路径；「预览能力」可以用，但默认关闭或有明确限制；「基础设施」只供内部维护使用。
| 能力 | 当前用途 |
|---|---|
| Chat / Build | 多会话对话和项目工作区隔离；一轮的思考和工具步骤收成一行「已处理 N 步」，点开看过程 |
| 权限预设与计划 | 控制写入范围、一次性提权、先规划再执行 |
| 模型 | 三步添加模型（连接、勾选、确认参数），自动读取厂商模型列表并预填上下文与输出上限；按供应商管理 Key 与地址；备用模型与任务费用上限 |
| 记忆 | 用户档案、全局长期记忆、项目私有记忆、版本恢复和 memory_edit |
| 附件 | 保存图片、文本和受支持的文档，并传入模型上下文 |
| 本地工具 | 文件读写与编辑、搜索、Shell（含后台任务）、Todo 与提问 |
| 网页读取与搜索 | web_fetch 读取公开网页（默认开启）；web_search 在模型使用 DeepSeek 官方 API 时可用；都可以在「设置 › 高级 › 网络工具」关闭 |
| 本地子智能体 | 在后台交出独立或继承上下文的子任务，可固定用某一条模型；在子智能体的页面直接给它发消息 |
| Skills / Plugins / MCP | 在「能力」页导入和编辑本地 Skill、安装版本化 Plugin、粘贴配置接入 MCP server、查看注册的工具；页顶「推荐」提供少量精选条目 |
| 右侧工作台 | Build 会话的审查（Git Review）、用户终端；任何会话可用的文件预览与内置浏览器 |
| 环境信息与导航 | 会话头部的环境信息卡、置顶会话、会话内容搜索、应用内通知、前进 / 后退和快捷键 |
| 用量与诊断 | 查看消耗、上下文、运行状态和环境问题；本机日志与可导出的诊断包（不含会话内容和密钥） |
| 存储与备份 | 查看各类数据占用并清理；导出备份与从备份恢复；较旧版本打开新数据时只读保护 |
| 检查更新 | 启动 30 秒后与每 24 小时查看 GitHub 上同一渠道的新版本，下载 DMG 并核对 SHA-256 与来源证明，放进「下载」文件夹；可在「设置 › 常规 › 更新」关闭 |
| 能力 | 入口与限制 |
|---|---|
| 目标 | /goal；同一会话内自动续跑，重启后需要显式恢复 |
| 定时任务 | 定时任务页面和 scheduler 工具；任务使用与普通对话相同的权限 |
| Claude Code / Codex 子智能体 | 「设置 › 子智能体」，默认关闭，使用你自己的订阅额度或 API 计费；第一次交给它们时先确认；改了文件的成果查看差异后再应用到项目，见子智能体 |
| GitHub | 侧栏「Pull Request」页；启用预装 GitHub 插件后可浏览 PR、议题与 CI，只读，需要本机已安装并登录的 GitHub CLI（gh） |
| 语音听写 | 输入框麦克风或 ⇧⌘D；本机识别、插入草稿、不自动发送，需要麦克风与语音识别权限 |
| Hooks | 「设置 › 高级 › Hooks」；hooks.json 配置，仅 command handler |