prime-agent

环境要求

• macOS/Linux 需支持 sh 与 curl；Windows 需 PowerShell
• 网络可访问 https://app.primeintellect.ai 以下载安装脚本与安装包
• 首次启动需要订阅或 API-key 提供商（在界面中用 /login 选择）
• 建议在可丢弃的克隆、干净 worktree 或其他可检查恢复的目录中运行

安装与启动步骤

1. 1Linux/macOS 安装

   用官方一键脚本安装最新稳定版 Prime Agent，需能访问 app.primeintellect.ai。

   curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh

   复制

2. 2Windows 安装

   在 PowerShell 中执行安装脚本，脚本会下载最新稳定版 Windows x64 构建并校验 checksum。

   irm https://app.primeintellect.ai/prime-agent/install.ps1 | iex

   复制

3. 3进入工作目录

   切换到希望 Prime Agent 工作的仓库或目录，建议用可丢弃克隆或干净 worktree，便于检查回滚。

   cd /path/to/project

   复制

4. 4启动 Prime Agent

   在当前目录启动，它会在此目录执行命令并修改文件；不要在有未保存改动的重要目录直接运行。

   prime-agent

   复制

5. 5首次登录配置

   在启动后的界面里执行 /login，按提示选择订阅或 API-key 提供商，完成后方可正常使用。

   /login

   复制

6. 6检查后台服务

   查看后台服务状态；如异常可执行 prime-agent doctor --fix 尝试修复。

   prime-agent status

   复制

7. 7查看与管理会话

   浏览运行中、空闲和已保存的会话，可据此重新接管之前的运行。

   prime-agent agents

   复制

关键配置

如何确认成功

执行 prime-agent status 查看后台服务状态，或 prime-agent doctor 检查服务是否正常。

常见问题

注意事项

• Prime Agent 以你的用户权限执行模型生成的代码和项目命令，不是安全沙箱；仅在可信仓库、指令和技能下使用。
• 不可信代码或指令请放到外部沙箱或受限环境中运行。
• 运行前请使用可丢弃的克隆、干净 worktree 或其他可检查恢复的检查点，并复核它做的改动。
• 可用 prime-agent shutdown 停止所有 agent、worker 和后台服务。