1ay1/agentty

해결하는 문제

agentty는 무거운 런타임 의존 도구를 대체하기 위해 설계된 고성능 터미널 기반 코딩 에이전트입니다. 느린 시작 시간, 전체 저장소를 LLM에 전송하는 '컨텍스트 덤프'로 인한 높은 토큰 비용, 그리고 특정 벤더에 종속되는 문제를 해결합니다. 빠르고 모델에 독립적인 바이너리를 제공하여 가장 관련성 높은 코드 스니펫만을 검색합니다.

작동 원리

C++26으로 작성된 agentty는 Node.js나 Python 의존성이 없는 단일 정적 바이너리로 작동합니다. 정교한 로컬 RAG(검색 증강 생성) 엔진을 사용하여 BM25 키워드 검색과 밀집 임베딩(dense embeddings)을 결합해 특정 코드 조각을 가져옵니다.

주요 아키텍처 특징:

• 스마트 모드: 오케스트레이터-워커 설계로, 플래그십 모델이 작업을 계획하고 복잡도에 따라 더 저렴한 모델에 작업을 위임합니다.
• 샌드박싱: 셸 및 빌드 명령은 OS 강제 샌드박스(Linux의 경우 seccomp/landlock, macOS의 경우 seatbelt) 내에서 실행되어 안전성을 보장합니다.
• 로컬 RAG 파이프라인: Reciprocal Rank Fusion, 리랭킹, GraphRAG 확장을 포함한 다단계 퍼널을 통해 클라우드 의존성 없이 고정밀 컨텍스트를 제공합니다.

대상 사용자

터미널에서 초고속이며 개인정보 보호를 중시하는 코딩 어시스턴트를 원하는 개발자에게 적합합니다. 모든 LLM 제공업체(Ollama를 통한 로컬 모델 포함)와 함께 사용할 수 있으며, 에어갭(air-gapped) 환경도 지원합니다.

주요 특징

• 극한의 성능: 콜드 스타트 1ms 미만; 단일 정적 바이너리 (~16.7 MB).
• 모델 독립성: Claude, GPT, Groq, OpenRouter, Ollama, DeepSeek, xAI, Gemini, Fireworks 지원.
• 고급 검색: 로컬 하이브리드 BM25 + 임베딩 검색과 GraphRAG 및 소스 코드 의미론적 검색 결합.
• 보안 우선: 셸 호출에 대한 기본 샌드박싱 및 SSH 릴레이를 통한 에어갭 모드 지원.
• 통합 도구: 코드 읽기, 쓰기, 편집, 검색을 위한 전체 도구 세트와 터미널에서 코드 블록을 대화형으로 실행하는 기능 제공.