agentty-org/agentty

AI pair programming in your terminal — one static binary, sub-ms startup, any model

agentty란 무엇인가?

agentty는 터미널에서 실행되는 네이티브 단일 바이너리 코딩 어시스턴트입니다. 대규모 언어 모델(Claude, GPT, Grok, Ollama 등)과 대화하여 코드를 작성, 편집, 실행할 수 있으며, 저장소에서 가장 관련성 높은 부분을 자동으로 검색하여 모델이 필요한 정보만 볼 수 있도록 합니다. 전체가 C++26으로 작성되었으며, 약 16MB 정적 실행 파일로 제공되고 Linux, macOS, Windows, Android/Termux에서 작동합니다.

핵심 아이디어

아이디어	의미
제로 런타임 종속성	Node, Python, `npm install` 불필요. 바이너리를 다운로드(또는 빌드)하고 실행하기만 하면 됩니다.
선택적 검색(RAG)	내장 하이브리드 BM25 + 밀집 임베딩 엔진이 관련 코드 스니펫만 가져와 전체 저장소를 덤프하는 것보다 프롬프트 컨텍스트를 80% 이상 줄입니다.
모델 비종속	모든 OpenAI 호환 엔드포인트, Claude, Groq, DeepSeek, Gemini, 로컬 Ollama 모델 등과 작동합니다. `^P`로 공급자를 즉시 전환할 수 있습니다.
샌드박스 실행	셸/빌드 명령이 OS 강제 샌드박스(Linux의 seccomp/landlock, macOS의 seatbelt) 내에서 실행되어 어시스턴트가 시스템을 실수로 손상시킬 수 없습니다.
에어갭 모드	대상 머신에 인터넷이 없을 때 agentty는 SSH 터널 SOCKS5 연결을 통해 트래픽을 중계하여 세션을 격리할 수 있습니다.
스마트 모드	오케스트레이터가 쉬운 작업을 저비용 모델로 라우팅하고 계획 중심 작업에는 플래그십 모델을 예약하며, 각 저장소에 적합한 노력 수준을 자동으로 학습합니다.

주요 기능(README에 설명된 대로)

즉시 시작 – 콜드 스타트 1ms 미만, 키 입력부터 픽셀까지 지연 시간 약 1ms.
전체 도구 모음 – 읽기/쓰기/편집, git, grep, search_docs, search_code, 웹 검색, 작업 관리 등이 모두 TUI를 통해 제공됩니다.
로컬 RAG 엔진 – 하이브리드 BM25 + HNSW 벡터 검색, 상호 순위 융합, 유사 피드백, MMR 다양화, GraphRAG 확장, 선택적 생성 리랭커를 모두 프로세스 내 C++로 구현.
샌드박스 명령 – Linux는 seccomp + landlock + cgroup2(폴백 bubblewrap) 사용; macOS는 seatbelt + rlimits(폴백 sandbox-exec) 사용.
에어갭 SSH 릴레이 – agentty airgap user@host는 TLS 고정 SOCKS5 터널을 설정합니다.
CLI 모드 – 일회성 스크립트용 agentty run "fix the failing test", 자동화용 --json/--events, 안전한 CI 실행용 --read-only/--no-network.
키 바인딩 – 전송, 스레드 탐색, 공급자 선택기 열기, Smart Mode 전환, 프롬프트 반복 등을 위한 Vim 스타일 단축키.
Zed 통합 – Agent Client Protocol을 지원하므로 Zed 편집기 내에서 Claude-Code 대체로 사용할 수 있습니다.

시작하기(빠른 시작)

# 설치(Linux/macOS/Windows/Termux) – 스크립트가 올바른 패키지를 선택합니다
curl -fsSL https://raw.githubusercontent.com/1ay1/agentty/master/install.sh | sh

cd /path/to/your/project
agentty               # 첫 실행 시 API 키 인증 프롬프트가 열립니다

패키지 관리자로도 설치할 수 있습니다:

Debian/Ubuntu: dpkg -i agentty_<version>_amd64.deb
Fedora/RHEL: dnf install https://…/agentty-<ver>-1.x86_64.rpm
macOS: brew tap 1ay1/tap && brew install agentty
Windows: scoop bucket add 1ay1 … && scoop install agentty 또는 winget install agentty.agentty
C++26 컴파일러로 소스에서 빌드(git clone … && cmake -B build && cmake --build build).

일반적인 워크플로우

저장소 열기 – cd my-app && agentty.
질문하기 – 로그인 핸들러에 대한 단위 테스트 추가 같은 내용을 입력하고 Enter를 누릅니다.
에이전트 검색 – RAG 엔진이 가장 관련성 높은 코드 스니펫을 가져와 조용한 📚 카드로 표시합니다.
모델 응답 – LLM이 편집 제안을 하며, 코드 블록을 포함할 수 있습니다.
실행 또는 적용 – ^G를 눌러 제안된 명령을 실행하고, ^R로 diff를 검토하거나, ^S로 Smart Mode가 다단계 리팩터링을 계획하도록 합니다.
반복 – 대화를 계속하고, 도구는 스레드 기록을 유지하며, ^P로 언제든지 공급자를 전환할 수 있습니다.

주요 기능(README에 설명된 대로)

즉시 시작 – 콜드 스타트 1ms 미만, 키 입력부터 픽셀까지 지연 시간 약 1ms.
전체 도구 모음 – 읽기/쓰기/편집, git, grep, search_docs, search_code, 웹 검색, 작업 관리 등이 모두 TUI를 통해 제공됩니다.
로컬 RAG 엔진 – 하이브리드 BM25 + HNSW 벡터 검색, 상호 순위 융합, 유사 피드백, MMR 다양화, GraphRAG 확장, 선택적 생성 리랭커를 모두 프로세스 내 C++로 구현.
샌드박스 명령 – Linux는 seccomp + landlock + cgroup2(폴백 bubblewrap) 사용, macOS는 seatbelt + rlimits(폴백 sandbox-exec) 사용.
에어갭 SSH 릴레이 – agentty airgap user@host는 TLS 고정 SOCKS5 터널을 설정합니다.
CLI 모드 – 일회성 스크립트용 agentty run "fix the failing test", 자동화용 --json/--events, 안전한 CI 실행용 --read-only/--no-network.
키 바인딩 – 전송, 스레드 탐색, 공급자 선택기 열기, Smart Mode 전환, 프롬프트 반복 등을 위한 Vim 스타일 단축키.
Zed 통합 – Agent Client Protocol을 지원하므로 Zed 편집기 내에서 Claude-Code 대체로 사용할 수 있습니다.

시작하기(빠른 시작)

# 설치(Linux/macOS/Windows/Termux) – 스크립트가 올바른 패키지를 선택합니다
curl -fsSL https://raw.githubusercontent.com/1ay1/agentty/master/install.sh | sh

cd /path/to/your/project
agentty               # 첫 실행 시 API 키 인증 프롬프트가 열립니다

패키지 관리자로도 설치할 수 있습니다:

Debian/Ubuntu: dpkg -i agentty_<version>_amd64.deb
Fedora/RHEL: dnf install https://…/agentty-<ver>-1.x86_64.rpm
macOS: brew tap 1ay1/tap && brew install agentty
Windows: scoop bucket add 1ay1 … && scoop install agentty 또는 winget install agentty.agentty
C++26 컴파일러로 소스에서 빌드 (git clone … && cmake -B build && cmake --build build).

일반적인 워크플로우

저장소 열기 – cd my-app && agentty.
질문하기 – 로그인 핸들러에 대한 단위 테스트 추가 같은 내용을 입력하고 Enter를 누릅니다.
에이전트 검색 – RAG 엔진이 가장 관련성 높은 코드 스니펫을 가져와 조용한 📚 카드로 표시합니다.
모델 응답 – LLM이 편집 제안을 하며, 코드 블록을 포함할 수 있습니다.
실행 또는 적용 – ^G를 눌러 제안된 명령을 실행하고, ^R로 diff를 검토하거나, ^S로 Smart Mode가 다단계 리팩터링을 계획하도록 합니다.
반복 – 대화를 계속하고, 스레드 기록을 유지하며, ^P로 언제든지 공급자를 전환할 수 있습니다.

누가 혜택을 볼 수 있나요?

무거운 IDE 확장보다 터미널을 선호하는 개발자.
보안이 엄격한 팀 – 샌드박스 실행 및 에어갭 모드로 비밀을 안전하게 보호합니다.
다양한 LLM 공급자를 사용하는 사람들 – 동일한 바이너리가 Claude, OpenAI, Groq, 로컬 Ollama 등과 작동합니다.
오픈소스 기여자 – 이 프로젝트는 MIT 라이선스, 완전 정적, 모든 플랫폼에서 컴파일 가능합니다.

더 알아보기

문서 – https://agentty.org/docs (CLI, 샌드박스, 검색, Smart Mode, 키 바인딩).
비교 – https://agentty.org/compare/agentty-vs-claude-code, Aider, Cursor 비교.
커뮤니티 – Discord, IRC, GitHub 이슈 트래커.

요약: agentty는 빠르고 자급자족하는 터미널 코딩 어시스턴트로, 최신 LLM 기반 코드 생성, 컨텍스트 인식 검색, 안전한 샌드박스 실행을 Node/Python 생태계의 오버헤드 없이 모든 OS에 제공합니다.

시작하기(빠른 시작)

# 설치(Linux/macOS/Windows/Termux) – 스크립트가 올바른 패키지를 선택합니다
curl -fsSL https://raw.githubusercontent.com/1ay1/agentty/master/install.sh | sh

cd /path/to/your/project
agentty               # 첫 실행 시 API 키 인증 프롬프트가 열립니다

패키지 관리자로도 설치할 수 있습니다:

Debian/Ubuntu: dpkg -i agentty_<version>_amd64.deb
Fedora/RHEL: dnf install https://…/agentty-<ver>-1.x86_64.rpm
macOS: brew tap 1ay1/tap && brew install agentty
Windows: scoop bucket add 1ay1 … && scoop install agentty 또는 winget install agentty.agentty
C++26 컴파일러로 소스에서 빌드(git clone … && cmake -B build && cmake --build build).

일반적인 워크플로우

저장소 열기 – cd my-app && agentty.
질문하기 – 로그인 핸들러에 대한 단위 테스트 추가 같은 내용을 입력하고 Enter를 누릅니다.
에이전트 검색 – RAG 엔진이 가장 관련성 높은 코드 스니펫을 가져와 조용한 📚 카드로 표시합니다.
모델 응답 – LLM이 편집을 제안하며, 코드 블록을 포함할 수 있습니다.
실행 또는 적용 – ^G를 눌러 제안된 명령을 실행하고, ^R로 diff를 검토하거나, ^S로 Smart Mode가 다단계 리팩터링을 계획하도록 합니다.
반복 – 대화를 계속합니다. 도구는 스레드 기록을 유지하며 ^P로 언제든지 공급자를 전환할 수 있습니다.

누가 혜택을 볼 수 있나요?

무거운 IDE 확장보다 터미널을 선호하는 개발자.
보안이 엄격한 팀 – 샌드박스 실행 및 에어갭 모드로 비밀을 안전하게 보호합니다.
다양한 LLM 공급자를 사용하는 사람들 – 동일한 바이너리가 Claude, OpenAI, Groq, 로컬 Ollama 등과 작동합니다.
오픈소스 기여자 – 프로젝트는 MIT 라이선스, 완전 정적, 모든 플랫폼에서 컴파일 가능합니다.

더 알아보기

문서 – https://agentty.org/docs (CLI, 샌드박스, 검색, Smart Mode, 키 바인딩).
비교 – https://agentty.org/compare/agentty-vs-claude-code, vs Aider, vs Cursor.
커뮤니티 – Discord, IRC, GitHub 이슈 트래커.

시작하기(빠른 시작)

# 설치(Linux/macOS/Windows/Termux) – 스크립트가 올바른 패키지를 선택합니다
curl -fsSL https://raw.githubusercontent.com/1ay1/agentty/master/install.sh | sh

cd /path/to/your/project
agentty               # 첫 실행 시 API 키 인증 프롬프트가 열립니다

패키지 관리자로도 설치할 수 있습니다:

Debian/Ubuntu: dpkg -i agentty_<version>_amd64.deb
Fedora/RHEL: dnf install https://…/agentty-<ver>-1.x86_64.rpm
macOS: brew tap 1ay1/tap && brew install agentty
Windows: scoop bucket add 1ay1 … && scoop install agentty 또는 winget install agentty.agentty
C++26 컴파일러로 소스에서 빌드(git clone … && cmake -B build && cmake --build build).

일반적인 워크플로우

저장소 열기 – cd my‑app && agentty.
질문하기 – 로그인 핸들러에 대한 단위 테스트 추가 같은 내용을 입력하고 Enter를 누릅니다.
에이전트 검색 – RAG 엔진이 가장 관련성 높은 코드 스니펫을 가져와 조용한 📚 카드로 표시합니다.
모델 응답 – LLM이 편집을 제안하며, 코드 블록을 포함할 수 있습니다.
실행 또는 적용 – ^G를 눌러 제안된 명령을 실행하고, ^R로 diff를 검토하거나, ^S로 Smart Mode가 다단계 리팩터링을 계획하도록 합니다.
반복 – 대화를 계속합니다. 도구는 스레드 기록을 유지하며, ^P로 언제든지 공급자를 전환할 수 있습니다.

누가 혜택을 볼 수 있나요?

무거운 IDE 확장 프로그램보다 터미널을 선호하는 개발자.
보안이 엄격한 팀 – 샌드박스 실행 및 에어갭 모드로 비밀을 안전하게 보호합니다.
다양한 LLM 공급자를 사용하는 사람들 – 동일한 바이너리가 Claude, OpenAI, Groq, 로컬 Ollama 등과 작동합니다.
오픈소스 기여자 – 이 프로젝트는 MIT 라이선스, 완전 정적, 모든 플랫폼에서 컴파일 가능합니다.

더 알아보기

문서 – https://agentty.org/docs (CLI, 샌드박스, 검색, Smart Mode, 키 바인딩).
비교 – https://agentty.org/compare/agentty-vs-claude-code, Aider, Cursor 비교.
커뮤니티 – Discord, IRC, GitHub 이슈 트래커.

요약: agentty는 Node/Python 생태계의 오버헤드 없이 모든 OS에서 현대적인 LLM 기반 코드 생성, 컨텍스트 인식 검색, 안전한 샌드박스 실행을 제공하는 빠르고 자급자족적인 터미널 코딩 어시스턴트입니다.