Acolyte: 터미널용 오픈소스 AI 코딩 에이전트

당신을 아는 에이전트.

Acolyte은 터미널을 위한 오픈소스 AI 코딩 에이전트입니다. 작업 과정에서 당신과 당신의 프로젝트에 대해 학습한 내용을 기억하므로, 같은 설명을 두 번 할 필요가 없습니다.

curl -fsSL https://acolyte.sh/install | sh

또는 Homebrew를 사용하는 경우:

brew install cniska/tap/acolyte

또는 npm을 사용하는 경우:

npm install -g @acolyte/cli

각 명령어는 macOS 및 Linux용 최신 릴리스 바이너리를 설치하며, 이 바이너리는 자동으로 업데이트를 유지하는 런처 뒤에 있습니다. 자세한 내용은 Updates 섹션을 참조하세요. 둘 중 하나만 선택하세요: 두 설치본은 PATH에서 서로 그림자처럼 존재합니다.

소스 코드에서 실행하려면 Local development 섹션을 참고하세요.

PATH에 Git 2.14 이상이 필요합니다.

: Acolyte은 모든 파일 편집을 Git diff로 보고하며, /workspaces는 Git worktree를 관리합니다.

CLI → typed RPC → task queue → lifecycle → model + tools

Daemon: CLI, 에디터 및 사용자 지정 클라이언트를 위한 타입이 지정된 RPC(Remote Procedure Call)가 있는 영구 서버입니다.Lifecycle: 명시적이고 테스트 가능한 단계(phases), 효과(effects) 및 완료 규칙입니다.Memory: 온디맨드(on demand)로 검색되는 지속적인 세션, 프로젝트 및 사용자 컨텍스트입니다.Workspace: 감지된 프로젝트 명령어와 도구 접근을 위한 검증된 경계입니다.Context: 계획된 입력 예산, 경계가 지정된 도구 페이로드, 그리고 가시적인 토큰 사용량입니다.Trace: 런타임 검사를 위한 로컬 작업 타임라인 및 구조화된 로그입니다.

코드베이스는 Bun 기반의 TypeScript이며, 런타임 경계에서는 Zod 유효성 검사(validation)를 사용하고 컨테이너 대신 직접적인 의존성 주입(dependency injection) 방식을 채택했습니다. 컴포넌트 모델은 Architecture 섹션을, 요청 실행은 Lifecycle 섹션을 읽어보세요.

mise와 Git 2.14 이상이 필요합니다.

git clone https://github.com/cniska/acolyte.git
cd acolyte
mise install
...

bun run dev

은 감시 모드(watch-mode) 데몬을 시작하고 CLI 클라이언트를 엽니다. 이 명령어는 이미 개발 포트를 사용 중인 로컬 데몬을 재시작한 다음, 클라이언트가 종료될 때 자신이 시작했던 데몬을 중지합니다.

매일 테스트 목적으로 사용하려면 체크아웃 CLI를 PATH에 연결하세요:

mkdir -p ~/.local/bin
ln -sf "$PWD/src/cli.ts" ~/.local/bin/acolyte

scripts/install.sh을 사용하세요.

최신 릴리스 바이너리를 로컬 소스 체크아웃 대신 사용하고 싶을 때만 해당됩니다.

테스트 스위트를 실행하는 데는 Provider 자격 증명이 필요하지 않습니다. 개발 중에 에이전트를 특정 Provider에 사용하려면, 사용자 계정에 대해 한 번 구성하십시오:

bun run src/cli.ts auth vercel --key

이렇게 하면 키가 Acolyte의 개인 전역 자격 증명 파일에 저장됩니다. 직접적인 Provider를 구성하려면 대신 openai, anthropic, 또는 google을 사용하십시오. 자격 증명 우선순위, 로컬 모델 및 Provider 설정은 [Configuration]을 참조하십시오.

반복 작업 중 집중적인 스위트를 실행하십시오:

bun test
bun run test:unit
bun run test:int
...

bun test는 모든 테스트를 실행합니다. bun run verify는 풀 리퀘스트(pull request) 전에 필요한 전체 검증입니다. 테스트 경계, 명명 규칙 및 커버리지에 대한 내용은 [Testing]을 참조하십시오.

소스 모듈 명명 규칙, 진입점(entry points), 테스트 접미사 및 서브시스템 디렉토리에 대해서는 src/README.md를 읽어보십시오.

낯선 서브시스템을 변경하기 전에 AGENTS.md를 읽으십시오. 여기에는 아키텍처 확장 지점, 불변성(invariants) 및 테스트 경계가 정의되어 있습니다.

기여 환영합니다. CONTRIBUTING.md와 AGENTS.md를 참조하십시오.

MIT © Christoffer Niska