<div align="center">
<h1>Agentty ADE</h1>
NPM Version
codecov
Postsubmit
Quality gate status
Bugs
Code Smells
Duplicated Lines (%)
Coverage
Agentty는 구조화되고 제어 가능한 AI 지원 소프트웨어 개발을 위한 **ADE(Agentic Development Environment)**입니다. Rust와 Ratatui로 구축되었으며, 자체적인 일상 사용을 통해 개선되어 에이전트, 검토(review), 반복(iteration) 기능을 하나의 집중된 터미널 워크플로우로 통합합니다.
설치 · 지원되는 CLI 에이전트 ·
사용법 · 문서화 · 기여 · 라이선스
<img src="https://raw.githubusercontent.com/agentty-xyz/agentty/HEAD/docs/site/static/demo/demo.gif" alt="Agentty 데모" width="900" />
</div>
Codex, Claude, 그리고 Antigravity 세션은 간결한 도구 상태 및 명령어 미리보기를 보여주며, 실패한 호출에 대한 출력 미리보기도 제공합니다. 명시적인 Claude 스킬 호출이 그 옆에 나타나고, 답변에는 저장된 사용 횟수가 유지됩니다.
세션 보기에서 w를 누르면 저장된 실행 그래프를 검사하거나, 정확한 출력을 수락하고, 작업을 재시도하거나, 디스패치(dispatch)를 재개하거나, 그래프를 취소할 수 있습니다. 그래프 노드와 제안에서 나오는 질문은 일반 턴의 질문과 동일한 질문 패널을 열어줍니다.
⚠️ [IMG:N]
--experimental-graph를 사용하고 /graph를 선택한 다음, 작업을 설명하세요. 일반 채팅은 왼쪽에 유지되며, 그래프 미리 보기와 실시간 상태는 너비의 최대 35%를 차지하는 오른쪽 창에 표시됩니다. 제안을 승인, 수정 또는 취소하려면 채팅에서 답장하세요. w는 세부 정보를 보여줍니다. 노드는 승인 후에만 실행됩니다. /graph는 하위 명령어가 없는 모드 선택기입니다.
그래프 제안은 번들링된 Markdown 에이전트 정의를 사용합니다. 저장소 오버라이드는 .agents/agents/<id>/agent.md에 있습니다. 지원되는 형식은 워크플로우 가이드를 참조하세요.
설치 (Installation)
npm (권장) (recommended)
npm, Bun, 및 pnpm 패키지는 PATH에 Node.js를 필요로 합니다. 전역 설치는 Agentty가 이를 식별할 수 있을 때 원래의 패키지 관리자를 통해 자동 업데이트를 지원합니다.
기타 방법 (Other methods)
<details>
<summary>Bun</summary>
</details>
<details>
<summary>pnpm</summary>
pnpm add --global agentty
만약 pnpm이 전역 bin-디렉터리 오류를 보고하면, pnpm setup을 실행하고 터미널을 다시 연 다음 재시도하세요.
</details>
<details>
<summary>npx (설치 없이 실행)</summary>
</details>
<details>
<summary>Shell</summary>
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/agentty-xyz/agentty/releases/latest/download/agentty-installer.sh | sh
</details>
<details>
<summary>Cargo</summary>
macOS 소스 빌드는 네이티브 프로세스 바인딩을 위해 Xcode Command Line Tools를 필요로 합니다.
</details>
지원되는 CLI 에이전트 (Supported CLI Agents)
Agentty는 현재 Codex, Claude, 및 Antigravity를 지원합니다. 세션을 시작하기 전에 최소한 하나의 제공업체 CLI를 설치하고 인증하세요:
- Codex (
codex, 권장; 구독 사용을 지원): Codex CLI를 설치하고 codex login을 실행하세요.
[!NOTE]
구독 기반 사용을 원할 때 Agentty의 권장 CLI 에이전트는 Codex입니다. Codex는 CLI를 포함하여 구독 액세스를 위해 ChatGPT로 로그인하는 것을 지원하며, Agentty는 Codex의 app-server 통합 인터페이스를 사용합니다. 사용은 OpenAI 이용 약관의 적용을 받습니다.
OpenClaw는 ChatGPT/Codex 구독 로그인을 일반적인 Codex harness 경로로 문서화하며, opencode는 자체 OpenAI provider에 대해 ChatGPT Plus 또는 Pro 인증을 권장합니다.
- Claude (
claude): Claude Code를 설치하고 claude auth login을 실행하세요.
[!WARNING]
claude -p를 통한 Agentty 사용의 경우, Claude Free, Pro 또는 Max 구독 로그인 대신 Claude 콘솔이나 지원되는 클라우드 제공업체를 통해 API 키 인증을 사용하세요. Anthropic의 Claude Code 법률 및 규정 준수 문서는 구독 OAuth를 Claude Code와 네이티브 Anthropic 애플리케이션의 일반적인 사용을 위해 의도된 것으로 설명하며, 개발자 통합은 API 키 또는 지원되는 클라우드 제공업체를 사용해야 합니다. Theo의 설명 비디오는 동일한 불확실성을 논하지만, 해당 코멘터리는 구독 기반 사용이 타사 도구 호출에 안전하다는 것을 보장하지 않습니다.
- Antigravity (
agy): Antigravity CLI의 버전 1.1.18 이상을 설치하고, 프롬프트가 나타날 때 agy를 실행하여 로그인하세요.
[!WARNING]
agy 헤드리스 모드를 통해 Agentty를 사용하려면, Antigravity 설정에 대해 Google 계정 구독 로그인 방식보다는 가용한 경우 Google Cloud 프로젝트 또는 API 키로 인증하는 방식을 사용하십시오. Antigravity 약관에는 agy 헤드리스 모드가 타사 도구에 의해 호출될 때 구독 액세스가 어떻게 적용되는지에 대해 아직 명확하게 설명되어 있지 않습니다.
Agentty는 사용자가 해당 제공업체의 CLI(Command Line Interface)를 통해 인증한 후, 각 제공업체의 공식 비대화형 CLI 또는 앱 서버 표면(claude -p, agy --input-format stream-json, 또는 codex app-server)을 사용합니다. Agentty는 OAuth 흐름(OAuth flows)을 구현하거나, 제공업체 OAuth 토큰을 직접 읽거나, 사설 제공업체 API를 호출하지 않습니다. 따라서 사용자 본인이 자신의 계정, 플랜 및 사용 패턴에 허용되는 인증 방법을 선택할 책임이 있습니다.
사용법 (Usage)
작업하려는 저장소에서 Agentty를 실행합니다:
agentty
agentty --no-update
agentty --otlp-endpoint http://localhost:4318/v1/traces
...
- 프로젝트(Projects): 디스커버리(discovery)는 선택 사항입니다. 프로젝트(Projects) 탭에서 경로(
a)를 통해 저장소를 추가하거나 지정된 폴더를 스캔(d)할 수 있습니다.
- 인스턴스(Instances): 주어진 Agentty 루트는 한 번에 하나의 Agentty 인스턴스만 사용할 수 있습니다. 별도의
AGENTTY_ROOT 디렉터리는 독립적으로 실행될 수 있습니다.
- 그래프(Graphs):
--experimental-graph는 노드가 실행되기 전에 검사하고, 수정하고, 승인할 수 있는 /graph 제안을 활성화합니다. 워크플로우 가이드를 참조하십시오.
- 하네스(Harness):
--experimental-harness는 로컬 또는 호스팅된 모델을 대상으로 Agentty의 내장 에이전트 루프를 실행하는 미리 보기 세션 유형을 추가합니다. 편집 모드에서는 격리되지 않은 셸 명령을 실행합니다. 하네스 세션을 참조하십시오.
- 추적(Tracing):
--otlp-endpoint가 완전한 OTLP HTTP/protobuf 트레이스 URL을 제공하지 않는 한 비활성화됩니다. /v1/traces로 끝나는 URL은 텔레메트리(telemetry)가 비활성화된 경우에도 사용량 이벤트를 OTLP 로그 레코드로 형제 /v1/logs URL로 전송합니다. 세션 추적을 참조하십시오.
- 텔레메트리(Telemetry): 기본적으로 활성화되어 있으며, 릴리스 빌드는 Agentty PostHog 프로젝트로 이벤트를 전송합니다. 비활성화하려면
AGENTTY_TELEMETRY_ENABLED=0으로 설정하십시오. 텔레메트리 상세 정보를 참조하십시오.
문서화(Documentation)
프로그래밍 방식 세션 API는 실행 전 작업(tasks)을 생성하고 목록화하며, 시도 제출 및 결과를 명시적으로 수락하는 기능을 지원합니다. 세션 소유권, 동시성(concurrency), 현재 제한 사항에 대해서는 작업 계약(task contract)을 참조하십시오.
또한 격리된 작업 대화, 정확한 출력 수락 및 공유 실행 제한을 갖춘 명시적 정적 실행 그래프를 지원합니다. 지원되는 프로파일과 라이프사이클 제한에 대해서는 실행 그래프(execution graphs)를 참조하십시오.
설치 및 워크플로우에 대한 문서는 agentty.xyz/docs에서 확인할 수 있습니다.
[!경고]
Agentty는 활발하게 개발 중입니다. 릴리스가 Semantic Versioning을 따르지만, 워크플로우(workflows), 통합(integrations), 안전장치(safeguards)가 발전함에 따라 현재의 0.y.z 시리즈는 릴리스 간에 여전히 호환성 깨지는 변경 사항(breaking changes)을 도입할 수 있습니다. Agentty가 사용자의 저장소(repositories)에 제안하거나 적용하는 변경 사항을 신뢰하기 전에 항상 검토하고 확인하십시오.
기여 (Contributing)
기여 지침은 CONTRIBUTING.md를 참조하십시오.
라이선스 (License)
Apache-2.0
