第一次会话
进入项目目录、启动 TUI、发第一句话。这一章只讲跑通路上必须会的手感。
1启动与第一句话
Prime Agent 在「当前工作目录」里干活，先 cd 到目标项目再启动。
cd /path/to/project
prime-agent启动后直接输入请求、回车。官方 Quickstart 的第一句话示例：
Summarize this repository and tell me how to run its checks.安全提醒（官方原文大意）：Prime Agent 会以你的用户权限执行模型生成的 Python 与项目命令。建议在一次性克隆、干净 worktree 或可检查可恢复的 checkpoint 里使用；worker 与 kernel 进程提供生命周期隔离与恢复能力，但不是安全沙箱。
它给模型的唯一内置工具是 ipython——一个长驻的 Python 内核，负责读写文件、跑项目命令、检查数据、保持 Python 状态、调用已安装技能。内核运行时在首次使用时自动引导；想用现成 Python 环境可设 PRIME_AGENT_KERNEL_PYTHON 指向带 prime-agent-runtime 的解释器。
2TUI 基本功：文件、命令、模型
六个高频操作，覆盖日常交互的九成场景。
| 操作 | 写法 | 效果 |
|---|---|---|
| 引用文件 | 编辑器里输入 @ | 模糊搜索项目文件，把文件带进请求 |
| 命令行传文件 | prime-agent @README.md "Summarize this" | 可同时挂多个文件一起审查 |
| 粘贴图片 | Ctrl+V（Windows 为 Alt+V）或拖拽 | 支持的终端可直接喂截图 |
| 跑 shell 命令 | !npm run lint | 输出送给模型；!!command 则不进模型上下文 |
| 切换模型 | /model 或 Ctrl+L | /effort 调推理力度；Alt+M 循环切换候选模型 |
| 重载上下文 | /reload | 改完 AGENTS.md / 技能后不用重启 |
命令行挂文件与图片的例子：
prime-agent @src/app.ts @src/app.test.ts "Review these together"
prime-agent -p @screenshot.png "What's in this image?"3用 AGENTS.md 告诉它项目规矩
上下文文件在启动时自动加载——项目约定写一次，次次生效。
Prime Agent 会加载：
~/.prime/agent/AGENTS.md—— 全局个人指令；- 项目路径上（父目录 + 当前目录）的
AGENTS.md或CLAUDE.md。
# Project Instructions
- Run `npm run check` after code changes.
- Do not run production migrations locally.
- Keep responses concise.改完上下文文件后，重启 Prime Agent 或执行 /reload 即可生效。
4会话管理：断点续聊
会话自动存成 JSONL 文件，位置在 ~/.prime/agent/sessions/，随时可回到任意节点。
prime-agent -c # 继续最近一次会话
prime-agent -r [path|id] # 浏览会话列表，或直接打开某个会话
prime-agent --no-session # 临时模式，不落盘会话内常用斜杠命令：
| 命令 | 作用 |
|---|---|
/resume | 打开代理视图或直接恢复某个会话 |
/new / /name | 开新会话 / 给会话命名 |
/tree | 跳回会话中的任意节点继续 |
/fork / /clone | 从某条用户消息分叉 / 复制当前分支成新会话 |
/compact [prompt] | 手动压缩上下文，可带自定义指令 |
/export / /share | 导出 HTML / 上传私有 GitHub gist 分享 |
持久会话跑在 worker 进程里：关掉 TUI 通常是「脱离」而不是「杀掉」，用
prime-agent agents 查看并重新接入正在跑的活（第六章展开）。5非交互模式：脚本里怎么用
一句话一答、管道输入、JSON 事件流、RPC 集成，四种姿势覆盖自动化场景。
# 单发即退
prime-agent -p "Summarize this codebase"
# 管道喂文本
cat README.md | prime-agent -p "Summarize this text"
# JSON 事件输出 / RPC 进程集成
prime-agent --mode json -p "List TODO comments"
prime-agent --mode rpc
最短可运行路径
cd 项目 → prime-agent → 说一句话 → 看 it 用 ipython 干活 → Ctrl+C 退出 → prime-agent -c 续聊。跑顺之后，进入第四章看它肚子里那套 RLM 编程模型。