TL;DR

  • Agentty는 구조적이고 제어 가능한 AI 지원 소프트웨어 개발을 위한 에이전트 개발 환경(ADE)으로, 여러 CLI 에이전트를 지원하며 세션·검토·반복 작업을 터미널 워크플로로 통합함.
  • Rust와 Ratatui로 구축됐으며, 일상적인 자체 사용을 통해 다듬어짐.
  • 설치 방식은 npm, npx, 셸 설치 스크립트, Cargo이며, 자동 업데이트는 기본 활성화됨.
  • Codex, Claude, Antigravity, Gemini를 지원하며, 각 제공자의 공식 비대화형 CLI 또는 앱 서버 인터페이스를 사용함.
  • 세션 추적은 기본 비활성화되고 원격 측정은 기본 활성화되며, 인증 방식과 Agentty가 제안하거나 적용하는 변경 사항을 사용자가 확인해야 함.

Agentty ADE

  • Agentty는 구조적이고 제어 가능한 AI 지원 소프트웨어 개발을 위한 에이전트 개발 환경(ADE)임.
  • Rust와 Ratatui로 구축됐으며, 자체 일상 사용을 거치며 다듬어짐. 에이전트, 검토, 반복 작업을 하나의 집중된 터미널 워크플로에 통합함.
  • 관련 항목: 설치, 지원 CLI 에이전트, 사용법, 문서, 기여, 라이선스.

설치

  • npm(권장, 자동 업데이트 지원): 전역 설치 방식으로 agentty를 설치함.
  • npx: 설치 없이 실행하는 방식임.
  • 셸 설치: https://github.com/agentty-xyz/agentty/releases/latest/download/agentty-installer.sh에서 설치 스크립트를 내려받아 실행하는 방식임.
  • Cargo: cargo install agentty로 설치하는 방식임. macOS에서 소스 빌드를 하려면 네이티브 프로세스 바인딩에 필요한 Xcode Command Line Tools가 필요함.

지원 CLI 에이전트

  • Agentty는 현재 Codex, Claude, Antigravity, Gemini를 지원함. 세션을 시작하기 전에 제공자 CLI를 하나 이상 설치하고 인증해야 함.
  • Codex(codex, 권장): Codex CLI를 설치한 뒤 codex login으로 로그인하는 방식임. 구독 사용량을 지원함.
  • 구독을 통해 사용하는 경우 Agentty에서 권장하는 CLI 에이전트임. CLI를 포함해 ChatGPT로 로그인해 구독에 접근할 수 있으며, Agentty는 Codex 앱 서버 통합 인터페이스를 사용함. 사용에는 OpenAI 이용 약관이 적용됨.
  • OpenClaw는 ChatGPT/Codex 구독 로그인을 일반적인 Codex 하네스 경로로 안내하며, opencode는 OpenAI 제공자 인증에 ChatGPT Plus 또는 Pro를 권장함.
  • Claude(claude): Claude Code를 설치하고 claude auth login으로 로그인하는 방식임.
  • Agentty에서 claude -p를 통한 사용에는 Claude Free, Pro, Max 구독 로그인이 아니라 Claude Console 또는 지원되는 클라우드 제공자를 통한 API 키 인증을 사용해야 함.
  • Anthropic의 Claude Code 법률 및 준수 문서는 구독 OAuth를 Claude Code와 Anthropic 네이티브 애플리케이션의 일반 사용을 위한 것으로 설명하며, 개발자 통합에는 API 키 또는 지원되는 클라우드 제공자를 사용하도록 안내함.
  • Theo의 설명 영상도 같은 불확실성을 다루지만, 논평은 제3자 도구 호출에 구독 사용이 안전하다는 보장이 아님.
  • Antigravity(agy): Antigravity CLI 버전 1.1.18 이상을 설치하고, 메시지가 표시되면 agy를 실행해 로그인하는 방식임.
  • Agentty에서 agy 헤드리스 모드를 사용할 때는 Antigravity 설정에서 가능한 경우 Google 계정 구독 로그인이 아니라 Google Cloud 프로젝트 또는 API 키에 기반한 인증을 사용해야 함. Antigravity 약관은 제3자 도구가 agy 헤드리스 모드를 호출할 때 구독 액세스가 어떻게 적용되는지 아직 명확히 설명하지 않음.
  • Gemini(gemini): Gemini CLI를 설치하고 API 키 또는 Vertex AI로 인증하는 방식임.
  • Google의 Gemini CLI에서 Antigravity CLI로의 전환 이후, Google 계정 OAuth를 이용한 ‘Google로 로그인’은 Gemini CLI에서 더 이상 작동하지 않음. API 키(GEMINI_API_KEY)와 Vertex AI 인증은 계속 작동하므로, Gemini 백엔드에는 둘 중 하나를 사용하거나 Antigravity(agy) 백엔드를 사용해야 함.
  • Agentty는 제공자 CLI로 인증한 뒤 각 제공자의 공식 비대화형 CLI 또는 앱 서버 인터페이스인 claude -p, agy --input-format stream-json, codex app-server, gemini --acp를 사용함.
  • Agentty는 OAuth 흐름을 구현하거나 제공자의 OAuth 토큰을 직접 읽거나 비공개 제공자 API를 호출하지 않음. 계정, 요금제, 사용 방식에 허용되는 인증 방법을 선택할 책임은 사용자에게 있음.

사용법

  • agentty: 자동 업데이트를 활성화한 상태로 실행하는 방식이며, 기본값임.
  • agentty --no-update: 자동 업데이트 없이 실행하는 방식임.
  • agentty --otlp-endpoint http://localhost:4318/v1/traces: 세션 추적을 내보내는 방식임.
  • agentty --help: 지원되는 명령줄 옵션을 표시하는 방식임.
  • agentty --version: 설치된 Agentty 버전을 표시하는 방식임.
  • 세션 추적은 --otlp-endpoint에 완전한 OTLP HTTP/protobuf 트레이스 URL을 지정하지 않으면 비활성화됨. 인증 헤더는 OTEL_EXPORTER_OTLP_TRACES_HEADERS 또는 OTEL_EXPORTER_OTLP_HEADERS에서 가져올 수 있음.
  • 트레이스에는 단계별 소요 시간, 도구 식별 정보, 사용 가능한 실행 파일 이름, 종료 코드, 출력 크기가 포함됨.
  • --otlp-capture-content를 추가하면 도구 명령, 인수, 결과를 각각 최대 4KiB 미리보기로 포함함.
  • 일반적인 자격 증명 표식이 감지되면 해당 미리보기 전체가 제외되지만, 임의의 비밀 정보는 여전히 포함될 수 있음. 프롬프트와 추론은 제외됨.
  • 제공자별 제한 사항은 세션 추적 문서를 참고하는 방식임.
  • 특정 Agentty 루트를 동시에 사용할 수 있는 Agentty 인스턴스는 하나뿐임. 다른 인스턴스를 실행하기 전에 실행 중인 인스턴스를 닫아야 함. 서로 다른 AGENTTY_ROOT 디렉터리는 독립적으로 실행 가능함.
  • 원격 측정은 기본 활성화됨. 릴리스 빌드는 Agentty의 PostHog 프로젝트로 이벤트를 전송함. 비활성화하려면 AGENTTY_TELEMETRY_ENABLED=0을 설정해야 함. 정확한 이벤트와 필드는 원격 측정 세부 정보에서 확인할 수 있음.

문서

  • 설치 및 워크플로 문서는 agentty.xyz/docs에서 제공됨.
  • Agentty는 활발히 개발 중임. 릴리스는 시맨틱 버저닝을 따르지만, 현재 0.y.z 시리즈에서는 워크플로, 통합, 보호 장치가 발전하는 과정에서 릴리스 사이에 호환성이 깨지는 변경 사항이 도입될 수 있음.
  • 저장소에 의존하기 전에 Agentty가 제안하거나 적용하는 변경 사항을 항상 검토하고 확인해야 함.

기여

  • 기여 지침은 CONTRIBUTING.md에서 확인할 수 있음.

라이선스

  • Apache-2.0.