配置参考

Agentty 保存的每个文件，以及 settings.json 中的每个键。

Agentty 把所有东西都放在 ~/.agentty/。其中大部分在设置（⌘,）里改更方便。

文件#

路径用途
~/.agentty/settings.json偏好设置
~/.agentty/workspaces.json工作区、标签页、分屏和分组
~/.agentty/themes/*.itermcolors导入的配色主题
~/.agentty/pricing.json非 Claude 模型的价格
~/.agentty/handoffs/Session Flow 与智能体迁移产生的上下文文档
~/.agentty/connectors.jsonAPI 连接器定义（不含密钥）
~/.agentty/agent-auth.json新智能体标签页的登录方式（不含密钥）
~/.agentty/codex-home/用 API 密钥登录时的专用 Codex 主目录
~/.agentty/worktrees/按会话创建的工作树
~/.agentty/plugins/已安装的插件
~/.agentty/plugin-data/<id>/各插件自己的数据
~/.agentty/prompts/以文件形式交给智能体的长提示词
~/.agentty/install_id用于使用统计的随机安装标识符
agentty.json（项目）或 ~/.agentty/commands.json命令面板的自定义条目

密钥不会出现在这些文件中，它们存放在操作系统的凭据存储里。

settings.json#

json
{
  "language": "zh",
  "theme": "Agentty Dark",
  "fontFamily": "JetBrains Mono",
  "fontSize": 13.0,
  "lineHeight": 1.25,
  "cursorShape": "block",
  "scrollback": 10000,
  "askDirectory": true,
  "autoWorktree": true,
  "agentTasks": true,
  "analytics": true,
  "agentBarPosition": "top"
}
键取值
languageen、ko、ja、zh
theme内置主题名，或导入的 .itermcolors 去掉扩展名的文件名
fontFamily、fontSize、lineHeight、padding外观
cursorShapeblock、beam、underline；cursorBlink 控制闪烁
scrollback每个终端保留的行数
askDirectory新建工作区时询问文件夹；askDirectoryForTabs 对标签页同理
resumeBar终端进入含有早先会话的文件夹时提示恢复
autoWorktree繁忙项目中的第二个会话获得独立工作树
agentTasks允许智能体请求开始并行任务，每次都要确认
agentGuide从这里启动的智能体会收到 Agentty 命令的简短说明
stopServersOnClose关闭窗格时停止其中启动的服务器
confirmClose关闭用过的东西前先确认
agentBarPositiontop 或 bottom
hud状态栏项目及顺序：model、context、usage、status、elapsed、links、spacer、ports、plugins、worktree、branch、folder
browser.autoOpenServers开发服务器有响应后在内置浏览器中打开
linkOpener⌘-点击使用内置浏览器还是默认浏览器
externalEditorauto、vsCode、cursor、system
harnessDetect、harnessPatterns、harnessSubmit、harnessAgentharness 的检测与行为
systemNotifications、notifyWhenFocused、notifyAnswerRequests、chatNotify通知
analytics是否同意匿名使用统计。false 或 DO_NOT_TRACK=1 时不发送任何内容
menuBar菜单栏图标（macOS）

自定义命令#

项目中的 agentty.json，或对所有项目生效的 ~/.agentty/commands.json，可向命令面板添加条目：

json
{
  "commands": [
    { "label": "Run tests", "command": "npm test" },
    { "label": "Deploy staging", "command": "./scripts/deploy.sh staging" }
  ]
}

pricing.json#

为价格未内置的模型指定每百万令牌的美元价格：

json
{
  "some-model": { "input": 1.25, "output": 10.0, "cacheRead": 0.125 }
}

cacheRead、cacheWrite 和 cacheWrite1h 为可选，默认分别是 input 的 10%、125% 和 200%。