設定リファレンス

Agentty が保持するすべてのファイルと、settings.json のすべてのキー。

Agentty はすべてを ~/.agentty/ に保存します。ほとんどは設定（⌘,）から変えるほうが簡単です。

ファイル#

パス用途
~/.agentty/settings.json設定
~/.agentty/workspaces.jsonワークスペース、タブ、分割、グループ
~/.agentty/themes/*.itermcolors読み込んだカラーテーマ
~/.agentty/pricing.jsonClaude 以外のモデルの価格
~/.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コマンドパレットの独自項目

秘密の値はこれらのファイルに入りません。OS の資格情報ストアにあります。

settings.json#

json
{
  "language": "ja",
  "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作業中のプロジェクトの 2 つ目のセッションに専用ワークツリー
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、harnessAgentハーネスの検出と挙動
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#

価格が内蔵されていないモデル向けの、100 万トークンあたりの USD です。

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

cacheRead、cacheWrite、cacheWrite1h は任意で、既定は input の 10%、125%、200% です。