Mingyi Atlas — Security skill for Claude Code

Mingyi Atlas

中文 | [English](README.en.md)


Mingyi Atlas 是一个面向软件工程和授权安全评估的终端 AI Agent。它提供交互式 TUI、无头自动化、持久化项目上下文、内置技能、浏览器/容器辅助能力，以及专用的渗透测试模式。

本项目发布为 `@mingyilab/mingyi-atlas`，并提供 `mingyi-atlas` 命令。

安装

npm install -g @mingyilab/mingyi-atlas
mingyi-atlas

也可以不全局安装，直接运行：

npx @mingyilab/mingyi-atlas

运行要求：

• Node.js >=22.19.0
• fd 或 fdfind 可选，但建议安装，用于更快的 @file 自动补全
• Docker 可选，但使用容器支持的渗透测试浏览器/工具运行器时需要 Docker

支持的运行环境包括 macOS、Linux，以及现代 x64 或 arm64 Node.js 构建上的 Windows。原生可选依赖会由包管理器按当前平台解析。

快速开始

启动交互式 TUI：

mingyi-atlas

运行一次无头任务：

mingyi-atlas --prompt "Review the auth module and summarize risks"

在无头自动化中使用渗透测试模式：

mingyi-atlas --mode pentest --prompt "Start an authorized assessment of https://example.test"

界面预览





核心特性

• 交互式终端 UI，支持持久线程和项目级状态。
• 支持 build、plan、fast 和 pentest 模式。
• 通过模型包配置支持多模型提供商。
• 支持 OAuth 和 API Key 认证。
• 项目与全局配置分别存放在 .mingyi-atlas/ 和 ~/.mingyi-atlas/。
• 内置技能加载机制，支持显式搜索和读取技能。
• Goal 模式用于较长周期的持续目标。
• 通过 /browser 配置浏览器自动化。
• 为渗透测试工作流提供结构化安全上下文、发现、报告和工具产物。

下一步计划

• Mastra Workflow 接入：为侦察、验证、报告生成、清理等确定性安全评估流程引入可复用工作流编排。
• Workflow Tool 接入：将关键工作流封装为语义清晰的模型工具，使 pentest mode 和专用子 Agent 能在合适上下文中自主选择调用。
• 逆向分析 Agent 模式：面向二进制、固件、移动应用和协议样本的辅助分析工作流。
• APK 渗透 Agent 模式：面向授权 Android APK 安全评估，覆盖静态分析、组件暴露面梳理、敏感配置审查和报告生成。

认证

可以使用 `/login` 登录支持 OAuth 的提供商，也可以在启动 CLI 前通过环境变量设置提供商 API Key。

常用 API Key 环境变量：

export ANTHROPIC_API_KEY=...
export OPENAI_API_KEY=...
export GOOGLE_GENERATIVE_AI_API_KEY=...

凭据会保存在本机的 `~/.mingyi-atlas/auth.json`。

渗透测试模式

渗透测试模式仅用于授权测试。它会为 Agent 提供面向安全任务的提示词、专用子 Agent、持久化目标上下文和受范围约束的工具。

渗透测试模式使用技能作为工作流指导。对于 benchmark、CTF 和夺旗类任务，它会优先使用 benchmark 工作流。对于 Atlas 风格的红队评估，它可以搜索并激活内置 Atlas 工作流技能，用于协调评估接收、OPPLAN 风格目标、专家委派、验证和报告。普通范围