Agentty/문서

설정 화면

설정(⌘,)의 각 페이지가 하는 일.

**⌘,**가 설정을 엽니다. 변경은 즉시 적용되고 ~/.agentty/settings.json에 저장됩니다.

사이드바는 페이지를 일반, AI, 작업, 연결 · 데이터, 시스템으로 나눕니다. 위의 검색창은 모든 페이지의 설정을 이름이나 설명으로 찾습니다. 결과를 고르면 그 페이지로 가서 해당 설정을 표시해 줍니다.

일반#

언어(English, 한국어, 日本語, 中文, Deutsch), 화면 모드(시스템 · 다크 · 라이트), 그리고 매일 쓰는 기능의 동작을 정합니다. 화면 모드를 시스템으로 두면 macOS 설정이 바뀔 때 함께 바뀝니다. 터미널은 어느 모드에서든 터미널 스타일에서 고른 테마를 그대로 씁니다.

설정하는 일
아이디어로 시작하기시작 화면과 + 메뉴에 아이디어 페이지를 제안
닫기 전 확인사용한 페인·탭·워크스페이스를 닫기 전에 묻기
휴지통 자동 삭제 기간삭제한 작업공간이 휴지통에 남아 있다가 완전히 지워지기까지의 기간. 1~365일, 기본 7일
세션마다 워크트리작업 중인 프로젝트의 두 번째 세션에 전용 git 워크트리 제공
작업공간 검색바 노출작업공간 이름과 그 안에서 나눈 대화 내용을 검색
최근 완료 작업 상위로 자동정렬꺼두면 직접 정리한 순서가 그대로 유지
닫을 때 서버 종료페인을 닫으면 거기서 시작한 로컬 서버를 종료
익명 사용 정보 수집 동의사용 통계 참고
메뉴 바 아이콘창을 닫아도 Agentty를 계속 실행(macOS)
원격 접속 기능 사용기본은 켜짐. 끄면 사이드 메뉴에서 원격 접속이 사라지고 원격 접속도 꺼짐
절전 방지켜짐은 기기를 깨워 둡니다(항상 또는 1~72시간). 에이전트는 에이전트가 작업하는 동안만, 꺼짐은 평소대로 절전합니다. 상태바의 컵 아이콘에서도 바꿀 수 있습니다

AI 설정#

Agentty가 에이전트 세션에 더하는 기능입니다.

설정하는 일
에이전트를 여는 방식채팅 또는 터미널. Claude Code·Codex가 어떻게 시작되든(터미널에서 실행해도) 이 방식으로 열립니다. ⇧⌘J는 앞에 있는 페인만 바꿉니다. 채팅 보기 참고
오케스트레이션오케스트레이션 사용으로 켜고 끕니다. 끄면 시작하는 메뉴가 모두 숨겨집니다. 켜 두면 새 오케스트레이션의 기본 모델, 함께 쓸 다른 에이전트, 계획을 보여 준 뒤 시작을 기다릴지, 작업공간과 탭 중 어디에 열지를 정합니다. 오케스트레이션 참고
Claude Advisor새 Claude 탭이 쓰는 Advisor
상태바에 Advisor 표시기본은 꺼짐. 켜면 Claude 탭의 상태바에 Advisor가 보이고, 그 탭만 바꿀 수 있습니다
AI CLI 상태바AI 페인 위의 바, 그리고 터미널 위·아래 중 어디에 둘지
에이전트에게 Agentty 사용법 알려주기여기서 시작한 에이전트에게 Agentty 명령 안내를 명령줄로 전달
병렬 작업에이전트가 분할 페인에서 작업을 시작하자고 요청할 수 있음. 요청마다 확인

에이전트#

이 컴퓨터의 에이전트 CLI입니다. 에이전트 권한은 Claude Code와 Codex 탭을 YOLO(Bypass) 모드로 시작할지 정합니다. 설치됨은 찾은 에이전트를 버전, 명령과 함께 보여줍니다. 비활성으로 두면 실행 메뉴, 시작 화면, 명령 팔레트에서 빠집니다(설치는 그대로). 새로 설치했다면 새로고침을 누르세요. 설치 가능은 CLI만 설치하면 Agentty에서 실행할 수 있는 에이전트입니다. 설치를 누르면 제공사의 공식 설치 명령이 새 터미널 탭에서 실행되고, 링크는 공식 사이트를 엽니다(공식 설치 명령이 없는 에이전트는 사이트 링크만 있습니다).

Claude Code를 펼치면 Claude Code 사용자 설정(~/.claude/settings.json, 또는 $CLAUDE_CONFIG_DIR)에 저장되는 자체 기능이 나옵니다. 에이전트 팀 모드(리드 세션이 팀원 세션을 시작하고 조율, 실험 기능), 항상 깊게 생각, 자동 업데이트입니다. 스위치가 뜻하는 키만 쓰고 파일의 나머지는 그대로 둡니다. 올바른 JSON이 아닌 파일은 건드리지 않습니다. 새 Claude Code 세션부터 적용됩니다. Codex는 ~/.codex/config.toml을 열 수 있습니다.

연동#

Agentty와 함께 쓰는 외부 서비스입니다. 서비스마다 카드 하나에 연결 상태가 보이고, 카드를 펼쳐 설정합니다.

  • GitHub — PR, 클론, 동기화는 GitHub CLI(gh)와 그 로그인을 그대로 씁니다. Agentty에는 아무것도 저장하지 않습니다. 터미널에서 로그인은 새 탭에서 gh auth login을 실행합니다.
  • Slack, Discord, Telegram — 알림을 보낼 곳입니다. 웹훅 URL이나 봇 토큰은 시스템 자격 증명 저장소에 저장됩니다. 여기로 알림 보내기로 서비스마다 켜고 끕니다. 무엇을 보낼지는 알림에서 정합니다.
  • Jira — 개발 칸반보드가 티켓을 가져올 사이트, 이메일, API 토큰입니다.

프로젝트#

새 탭이 시작할 위치, Agentty가 찾을 하네스 패턴, 하네스 프롬프트를 바로 보낼지, 어떤 에이전트가 하네스 작업을 시작할지 정합니다. 편집기에서 열기가 사용할 편집기도 여기 있습니다. 파일 편집기의 언어 서버 목록과, 없는 언어 서버의 설치 버튼도 여기 있습니다. 줄 끝 문제 표시, 입력 중 자동 완성, 마우스 아래 타입 표시, 저장할 때 파일 서식 맞추기(기본은 꺼짐. 켜면 ⌘S가 먼저 ⇧⌥F와 같은 포매터로 정렬), 스티키 스크롤 같은 파일 편집기 옵션도 여기서 켜고 끕니다.

워크스페이스#

Agentty 창(⇧⌘N으로 새 창)마다 워크스페이스 목록이 따로 있습니다. 이 페이지에는 열린 창과 최근에 닫은 창이 나오고, 창마다 들어 있는 워크스페이스와 실행 중인 터미널 수도 보입니다. 워크스페이스를 누르면 그곳으로 갑니다. 앞으로 가져오기는 열린 창을 보여 줍니다. 다시 열기는 닫은 창을 다시 엽니다. 삭제는 먼저 물어본 뒤 창을 닫고 그 안의 워크스페이스를 지웁니다. 대화 기록은 세션 목록에 남습니다. 메인 창은 삭제할 수 없습니다.

계정#

전체 내용은 여러 계정에 있습니다.

설정 위의 계정 아이콘에서 Claude Code와 Codex 계정을 여러 개 로그인할 수 있습니다. 계정마다 자기 창에서 자기 세션과 사용량으로 동작하고, 여러 계정을 동시에 돌릴 수 있습니다. 설정, 스킬, 규칙, MCP 서버는 공유됩니다. 계정을 누르면 그 계정의 창이 앞으로 오거나 새로 열립니다. 이 설정 화면에서 계정 줄을 펼치면 폴더(열기, 복사), 에이전트를 그 폴더로 보내는 환경 변수, 로그인 정보가 저장된 곳이 보이고, 다시 로그인과 삭제가 있습니다. 폰에서는 작업공간에 계정이 표시되고, 새 작업공간은 열린 창의 계정 중에서 고를 수 있습니다. 계정을 삭제하면 로그아웃하고 이 컴퓨터에 있는 그 계정의 세션도 삭제합니다. 그 계정으로 실행 중인 패널이 있으면 삭제되지 않습니다. 동기화도 계정 단위입니다. 창은 Claude Code 계정, 없으면 Codex 계정 기준으로 전용 저장소에 동기화하고, 두 계정이 한 저장소를 함께 쓸 수 없습니다. 그 창에 있는 다른 계정의 세션은 이 저장소로 동기화되지 않습니다. 기본 계정은 ~/.claude와 ~/.codex의 로그인입니다. 삭제할 수 없고, 다시 로그인으로 바꿉니다. 로그인이 풀렸거나 2일 안에 만료되는 계정은 그렇게 표시되고 옆에 다시 로그인이 나옵니다. 계정이 두 개 이상인 Claude Code나 Codex를 시작하면 어느 계정으로 시작할지 매번 묻고, 처음에는 그 창의 계정이 선택되어 있습니다. 터미널(분할창 포함)에 claude나 codex를 직접 입력해도 똑같이 묻고, 고른 계정으로 실행됩니다. Esc로 닫으면 실행하지 않습니다. 계정이 하나뿐이면 묻지 않습니다. 창과 다른 계정으로 실행 중인 창에는 상태 바 맨 앞에 그 계정의 첫 글자가 파란 원으로 표시되고 상태 바 아래에 파란 선이 그어집니다. 원을 누르면 그 계정의 요금제, 5시간·주간 사용량과 초기화까지 남은 시간, 최근 7일 사용량이 나옵니다. 상태 바를 끈 채 채팅 보기로 보면 같은 원이 입력창 아래에 나옵니다. 로그아웃된 로그인이 있거나 이틀 안에 끝나는 로그인이 있으면 설정 위의 계정 아이콘에 경고 표시가 붙습니다.

새 Claude Code·Codex 탭이 로그인하는 방식입니다. 기본값에서는 아무것도 바꾸지 않고 에이전트가 자체 로그인을 그대로 씁니다. 대안과 자격 증명 보관 위치는 확장·MCP·커넥터를 참고하세요.

모양#

테마, 글꼴, 글꼴 크기, 줄 높이, 자간, 굵은 글씨, 배경·글자·커서·선택 영역의 직접 고른 색, 커서 모양과 깜박임, 여백, 스크롤백. 에이전트 상태 바에 어떤 항목을 어떤 순서로 둘지도 여기서 정합니다. 테마와 글꼴을 참고하세요.

키보드 단축키#

전체 목록을 사용 중인 플랫폼의 표기로 보여 줍니다. 키보드 단축키를 참고하세요.

알림#

시스템 알림, Agentty가 앞에 있을 때도 알릴지, 그리고 채팅 서비스로 보낼 내용(완료 알림, 요청 내용, 화면에 떠 있는 세션)을 정합니다. Slack, Discord, Telegram 연결은 연동에서 합니다. 에이전트 상태를 참고하세요.

동기화#

작업공간과 에이전트 세션을 내 비공개 Git 저장소(gh를 통한 GitHub, 또는 SSH URL)에 올려 여러 컴퓨터에서 이어 씁니다. 비어 있거나 이미 동기화에 쓰는 비공개 저장소만 목록에 나옵니다. 작업공간은 에이전트가 턴을 마쳤을 때, 탭을 닫았을 때, 아무 동작이 없으면 5분마다, 지금 동기화를 누를 때 동기화됩니다. 실패한 동기화는 저절로 다시 시도합니다.

**이 컴퓨터 (SQLite)**는 저장소도, 계정도, 설치도 필요 없습니다. 모든 내용이 ~/.agentty/sessions.sqlite 파일 하나에 들어갑니다(macOS와 Linux에 기본으로 들어 있는 SQLite를 쓰고, Windows에서는 Agentty에 들어 있습니다). 이 컴퓨터의 세션 백업이라, 에이전트 폴더(~/.claude, ~/.codex)에서 세션이 사라져도 동기화 팝업의 이어하기로 파일에서 되살릴 수 있습니다. 설정 → 동기화에서 파일 크기와 폴더에서 보기를 볼 수 있습니다. 다른 컴퓨터로 옮기려면 파일을 그 컴퓨터의 ~/.agentty에 복사하고 **이 컴퓨터 (SQLite)**를 고르면 세션이 되살아납니다. 연결을 끊어도 파일은 남습니다. 다른 컴퓨터와 저절로 공유되지는 않으니, 공유하려면 Git 저장소를 쓰세요. 둘을 함께 쓰려면 저장소를 연결한 상태에서 SQLite에도 함께 보관을 켜세요. 동기화할 때마다 저장소 내용(모든 컴퓨터의 세션)이 같은 파일에도 저장되어, 저장소가 없어도 백업으로 쓸 수 있습니다.

설정 동기화를 켜고 저장을 누르면 설정, 사용자 명령, 커넥터, 가져온 테마, 플러그인 설정도 함께 맞춰집니다. 가장 최근 변경이 우선하고, 새로 연결한 컴퓨터는 저장소에 이미 있는 설정을 받아 옵니다. 비밀값(API 키, 토큰, 비밀번호)은 동기화되지 않으니 컴퓨터마다 한 번씩 입력하세요. 비밀값처럼 보이는 내용이 든 부분(예: 토큰을 적어 둔 사용자 명령)은 그 컴퓨터에만 남고 다른 컴퓨터의 값으로 덮어쓰이지도 않습니다. 어느 부분인지는 동기화 팝업에 나옵니다.

오래된 세션 정리는 저장소가 끝없이 커지지 않게 합니다(GitHub 비공개 저장소 용량은 무제한이 아닙니다). 30·90·180·365일(또는 직접 정한 기간) 동안 바뀌지 않은 세션은 더 이상 동기화하지 않습니다. 저장소에서 지우기 전에는 동기화 팝업에서 확인을 받습니다. 기간은 저장소 단위로 정하므로 모든 컴퓨터가 같은 값을 씁니다.

컴퓨터는 Agentty가 ~/.agentty/computer-id에 만들어 두는 ID로 구분합니다(하드웨어 정보는 읽지 않습니다). ~/.agentty를 지우면 새 컴퓨터로 표시됩니다. 작업공간을 동기화 데이터도 삭제로 지우면 모든 컴퓨터에서 지워집니다. 저장소에 모든 버전이 남으므로 백업 역할도 합니다. 저장소는 비공개여야 하며, 공개 상태인 동안에는 동기화가 멈춥니다.

백업#

구성 내보내기는 전체 구성을 .agenttyconfig 파일 하나로 저장합니다. 설정, 사용자 명령, 커넥터, 데이터베이스 연결, 에이전트 로그인 방식, 가져온 테마, 설치한 플러그인 목록과 플러그인 설정이 들어갑니다. 패널 크기·최근 폴더처럼 한 컴퓨터에만 해당하는 값은 빠집니다. 비밀값 포함을 켜면 자격 증명 저장소의 API 키, 토큰, 비밀번호와 비밀값이 든 플러그인 설정도 넣습니다. 이 값들은 직접 정한 비밀번호로 암호화합니다(PBKDF2 + AES-256-GCM). 끄면 비밀값이 든 플러그인 설정은 빠집니다. Agentty는 이 비밀번호를 보관하지 않습니다.

구성 가져오기는 이 컴퓨터의 구성을 파일의 구성으로 바꿉니다. 설정은 파일 값이 우선하지만 이 컴퓨터의 패널 크기와 최근 폴더는 그대로 둡니다. 명령·커넥터 등 나머지 파일은 통째로 교체됩니다. 비밀번호를 비워 두면 비밀값만 빼고 가져옵니다. 없는 플러그인은 마켓플레이스나 Git 저장소에서 설치할 수 있습니다. 가져오기 전 구성은 매번 ~/.agentty/backups/에 보관됩니다.

브라우저#

링크를 인앱 브라우저와 기본 브라우저 중 어디서 열지, 개발 서버를 저절로 열지, 검색 엔진을 무엇으로 할지 정합니다. 링크를 기본 브라우저에서 열도록 하면 인앱 브라우저는 꺼집니다. 지구본 버튼이 사라지고, 페이지는 기본 브라우저에서 열리며, 에이전트는 브라우저 도구를 받지 않고, 여기에는 링크 선택만 남습니다. 플러그인 자체 페이지는 여전히 Agentty 안에서 열립니다.

시스템 점검#

Agentty가 쓰는 도구(Git, Node.js, 에이전트 CLI 등)와 설치 여부를 보여 줍니다. 빠진 도구는 여기서 새 터미널 탭을 열어 설치할 수 있습니다.

Agentty 정보#

버전, 업데이트 확인, 그리고 개인정보처리방침, 이용약관, 라이선스 계약 링크입니다.

빌드에는 지금 쓰는 Agentty의 정보가 나옵니다. 버전, 커밋, 빌드 날짜, 프로필(release / debug), 대상 플랫폼, Rust 버전, 기기 내 음성 인식 포함 여부가 있고, 이어서 Agentty가 제공하는 인터페이스의 API 버전(플러그인 API, 마켓플레이스 목록, MCP, 셸 연동, 설정 백업 파일, 세션 동기화 형식)이 나옵니다. 빌드 정보 복사를 누르면 이 내용이 영어 일반 텍스트로 복사되니 버그 신고에 붙여 넣으세요. 경로, 사용자 이름, 키는 들어 있지 않습니다.

오픈소스에는 Agentty를 만드는 데 쓰인 것들이 나옵니다. 함께 들어 있는 글꼴, 아이콘, 스크립트와 macOS, Windows, Linux에서 링크하는 모든 라이브러리가 버전, 라이선스, 홈페이지 링크와 함께 나오고, 이어서 라이선스 전문이 나옵니다.