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명령 팔레트의 사용자 항목

비밀 값은 이 파일들에 들어가지 않습니다. 운영체제의 자격 증명 저장소에 있습니다.

settings.json#

json
{
  "language": "ko",
  "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작업 중인 프로젝트의 두 번째 세션에 전용 워크트리 제공
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.discordBot웹훅 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%입니다.