Agentty/ドキュメント

設定リファレンス

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

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

ファイル#

パス用途
~/.agentty/settings.json設定
~/.agentty/workspaces.jsonワークスペース、タブ、分割、グループ
~/.agentty/themes/*.itermcolors読み込んだカラーテーマ
~/.agentty/pricing.jsonClaude 以外のモデルの価格
~/.agentty/handoffs/オーケストレーション (セッション連携) とエージェント移行が作るコンテキスト文書
~/.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,
  "orchestration": true,
  "orchestrationProfile": "balanced",
  "orchestrationHelpersOff": [],
  "orchestrationConfirmPlan": true,
  "orchestrationInTab": false,
  "analytics": true,
  "agentBarPosition": "top"
}
キー値
languageen、ko、ja、zh、de
theme内蔵テーマ名、または読み込んだ .itermcolors の拡張子なしのファイル名
fontFamily、fontSize、lineHeight、padding外観
cursorShapeblock、beam、underline。cursorBlink で点滅
letterSpacingターミナルのセルごとに加える幅(pt、0–8)
boldText通常のテキストを太字で描画。元から太字の部分はさらに太くなる
colorBackground、colorForeground、colorCursor、colorSelection手で置き換えたテーマの色。0xRRGGBB を数値で書く — JSON に 16 進リテラルはないので 0x121212 は 1184274
scrollbackターミナルごとに保持する行数
askDirectory新しいワークスペースでフォルダを尋ねる。askDirectoryForTabs はタブに対して同様
resumeBar以前のセッションがあるフォルダに入ったら再開を提案
autoWorktree作業中のプロジェクトの 2 つ目のセッションに専用ワークツリー
agentTasksエージェントが並列タスクの開始を要求できるようにし、毎回確認
orchestrationオーケストレーションを使う。オフで開始メニューと表示をすべて隠す
orchestrationProfile新しいオーケストレーションの既定モデル: balanced、quality、economy
orchestrationHelpersOff新しいオーケストレーションが既定で外す他のエージェント(codex、gemini、agy)
orchestrationConfirmPlanオーケストレーターが計画を見せて開始を待つ
orchestrationInTab新しいオーケストレーションを前面のワークスペースの新しいタブで開く
agentGuideここで起動したエージェントに Agentty のコマンド案内を渡す
stopServersOnCloseペインを閉じたら、そこで起動したサーバーを終了
confirmClose使用したものを閉じる前に確認
trashRetentionDays削除したワークスペースが完全に削除されるまでゴミ箱に残る日数(既定は 7 日)
agentBarPositiontop または bottom
workspaceSearchBarワークスペース一覧の上の検索欄。名前と、その中の会話を検索(既定でオン)
sortFinishedToTopエージェントが終えたワークスペースを一番上へ(既定でオフ。オフなら自分で並べた順序のまま)
hudステータスバーの項目と順序: model、context、usage、status、elapsed、links、spacer、ports、worktree、branch
browser.autoOpenServers開発サーバーが応答したらアプリ内ブラウザで開く
linkOpener⌘-クリックがアプリ内ブラウザか既定のブラウザか
externalEditorauto、vsCode、cursor、system
harnessDetect、harnessPatterns、harnessSubmit、harnessAgentハーネスの検出と挙動
systemNotifications、notifyWhenFocused、notifyAnswerRequests、chatNotify通知
chatNotify.slackBot、chatNotify.discordBotWebhook URL ではなくボットトークンとチャンネルで送る
chatNotify.slackChannel、chatNotify.discordChannelボットが書き込むチャンネル。Slack は #general・general・チャンネル ID、Discord はチャンネル ID
analytics匿名の利用統計への同意。false または DO_NOT_TRACK=1 なら何も送らない
menuBarメニューバーのアイコン(macOS)
advisorStatusClaude タブのステータスバーの Advisor 表示(既定はオフ)
hiddenAgents設定 → エージェント でオフにしたエージェント id(claude、codex、gemini など)。ランチャー、スタート画面、パレットから外れる
preventSleep, preventSleepAgentsマシンを常に、またはエージェントの作業中だけ起こしておく

独自コマンド#

プロジェクトの 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% です。