linuztx/alter-zero코딩, 사이버보안, 자동화를 위한 RAM 효율적인 터미널 에이전트 하네스.
당신과 함께 작업하는 에이전트와 코드를 읽고, 빌드하고, 디버깅하고, 리뷰하세요.
사이버보안 연구, 기술 조사, 일상적인 자동화에도 동일한 도구를 사용하세요.
Alter Zero는 Rust로 작성된 오픈소스 AI 코딩 에이전트입니다. 프로젝트에서 직접 작동하며 파일을 읽고, 편집하고, 명령을 실행하고, 결과를 확인하는 과정을 터미널에서 함께 지켜볼 수 있습니다. 코딩에 초점을 맞추면서도 보안 문제를 조사하고, 낯선 시스템을 탐색하고, 기존 도구를 활용해 작업을 자동화할 수 있는 유연성을 갖추고 있습니다.
| 제공되는 것 | 중요한 이유 |
|---|---|
| 따라갈 수 있는 작업 | 실시간 명령 출력, 읽기 쉬운 diff, 작업 체크리스트로 진행 상황을 쉽게 확인할 수 있습니다. |
| 실행에 대한 제어 | 권한 모드를 선택하고, 제안된 변경 사항을 검토하며, 작업 중인 에이전트를 조정할 수 있습니다. |
| 원하는 모델 선택 | 지원되는 구독 또는 API 키로 연결하거나, Ollama로 로컬 모델을 실행할 수 있습니다. |
| 확장의 여지 | 전문 서브에이전트, 재사용 가능한 스킬, 라이프사이클 훅, MCP 서버를 추가해 워크플로에 맞출 수 있습니다. |
| 네이티브 터미널 경험 | 영구 세션, 인라인 이미지, 키보드 중심 제어를 갖춘 단일 Rust 바이너리입니다. |
Alter Zero는 최신 터미널에서 Linux(x86_64, arm64)와 macOS(Intel, Apple silicon)에서 실행됩니다.
Linux 또는 macOS에서 한 줄:
curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh | sh
이 스크립트는 사용 중인 머신에 맞는 빌드를 선택하고, 릴리스와 함께 게시된 체크섬과 SHA-256을 검증한 뒤, alter-zero를 ~/.local/bin에 설치하고, 해당 디렉터리가 PATH에 없으면 알려줍니다.
ALTER_ZERO_INSTALL_DIR를 설정하면 다른 위치에 설치할 수 있고, ALTER_ZERO_VERSION=vX.Y.Z로 릴리스를 고정할 수 있습니다. CHANGELOG.md에 버전 간 변경 사항이 기록되어 있습니다.
ALTER_ZERO_INSTALL_DIR="$HOME/bin" ALTER_ZERO_VERSION=v0.1.0 \
sh -c "$(curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh)"
수동 설치의 경우, 각 릴리스 노트에 SHA-256과 함께 모든 아카이브가 나열되어 있으므로 직접 다운로드하고, 검증하고, 압축을 풀 수 있습니다.
docker/는 최신 릴리스를 기반으로 동작하는 명령줄 도구 세트를 갖춘 작은 헤드리스 Kali Rolling 이미지를 Docker 또는 Podman용으로 빌드합니다. 한 명령으로 빌드하고 원하는 폴더에서 컨테이너를 시작할 수 있습니다:
docker/build.sh ~/projects/site # add --engine podman for Podman
docker exec -it -e TERM -e COLORTERM -e TERM_PROGRAM -e KITTY_WINDOW_ID -e TMUX \
alter-zero-kali alter-zero
멀티플렉서 외부에서는 -e 플래그가 터미널의 정체성을 전달하여
그림이 반 블록이 아닌 실제 이미지로 렌더링되도록 합니다.
컨테이너 가이드에서는 워크스페이스, 게시된 포트,
이미지 붙여넣기, 도구 추가를 다룹니다.
tmux 내부에서는 호스트에서 allow-passthrough를 활성화하고 해당 docker exec에 대해
외부 터미널의 이미지 프로토콜을 명시적으로 선택하세요.
tmux 지침에는 바로 실행할 수 있는
Podman 예제가 포함되어 있습니다.
rustup과 C 컴파일러가 필요합니다. 저장소는 Rust 툴체인을 고정하고 있으며, rustup이 자동으로 설치합니다.
git clone https://github.com/linuztx/alter-zero.git
cd alter-zero
cargo install --path .
alter-zero
제공자가 구성되지 않은 경우, Alter Zero는 스크립트된 턴이 있는 오프라인 데모를 열어 인터페이스를 살펴볼 수 있게 합니다. 자신의 작업을 진행하려면:
/login**을 실행하고 지원되는 구독, API 제공자 또는 로컬 모델 서버를 선택하세요. 안내에 따라 연결하세요./model**을 실행해 모델을 선택하세요. Alter Zero는 이 디렉터리에 대한 선택을 기억합니다./login을 통해 추가된 로그인 정보는 저장소 외부의 ~/.alter-zero/.env에 저장됩니다. /로 명령을 탐색하거나 빈 컴포저에서 ?로 단축키를 확인하세요.
실행 전에 제공자를 선택할 수도 있습니다. 해당 API 키 변수와 제공자 ID를 설정한 뒤 앱을 시작하세요. 예를 들어 OpenRouter의 경우:
export OPENROUTER_API_KEY="your-api-key"
export ALTER_ZERO_PROVIDER=openrouter
alter-zero
/model로 모델을 선택하거나, 실행 전에 ALTER_ZERO_MODEL을 해당 모델 ID로 설정하세요.
구체적인 작업으로 시작하고 에이전트가 함께 처리하도록 하세요.
| 사용 사례 | 이렇게 요청해 보세요 |
|---|---|
| 코딩 및 디버깅 | "이 테스트가 실패하는 이유를 찾아 원인을 수정하고 관련 테스트를 실행해 줘." |
| 사이버보안 연구 | "이 저장소의 보안 취약점을 검토해 줘. 각 발견 사항을 코드까지 추적하고 수정 방안을 제안해 줘." |
| 기술 조사 | "이 프로젝트에서 인증이 어떻게 작동하는지 추적하고 접근 검사가 어디서 일어나는지 설명해 줘." |
| 자동화 | "이 로그를 요약하고 반복되는 오류를 표시하는 스크립트를 작성해 줘." |
지원되는 구독 서비스, API 제공자 또는 로컬 모델 서버에 연결하세요. /login으로 연결하고 /model로 모델을 선택하세요.
| 제공자 | 연결 방법 | 알아두면 좋은 점 |
|---|---|---|
| Agent Zero API | API 키. | Agent Zero 프록시를 통해 Venice.ai 모델에 접근하며, A0T 토큰 보유자에게는 매일 무료 할당량이 제공됩니다. |
| Venice | API 키. | Venice 자체 API에서 직접 제공하는 Venice.ai의 비공개, 무검열 모델 — Agent Zero API가 프록시하는 것과 동일한 카탈로그를 자신의 계정으로 접근합니다. |
| GitHub Copilot | 구독, 일회용 디바이스 코드 사용. | 컨텍스트 윈도우, 비전, 추론 수준을 포함한 모델 기능은 Copilot에서 제공됩니다. |
| ChatGPT Codex | 구독, ChatGPT Plus 또는 Pro 계정 사용: 브라우저 로그인 또는 헤드리스 머신에서 일회용 디바이스 코드. | 계정 로그인 흐름을 사용하며 붙여넣을 API 키가 없습니다. |
| Anthropic | API 키 또는 Anthropic Console을 통한 계정 로그인. | 두 방법 모두 사용량은 API 조직에 청구됩니다. |
| OpenRouter | API 키. | 하나의 계정으로 여러 제공자의 모델에 접근합니다. |
| Ollama | Alter Zero를 로컬 서버로 지정하세요; 키가 필요하지 않습니다. | 로컬에서 호스팅되는 모델로 자신의 머신에서 추론을 실행합니다. |
| Ollama Cloud | API 키. | Ollama가 호스팅하는 오픈 모델을 사용합니다. |
푸터에는 활성 모델, 사고 모드, 속도 등급, 컨텍스트 사용량이 표시됩니다. Ctrl+T는 모델이 지원하는 추론 수준을 순환하고, 속도 등급을 나열하는 ChatGPT 모델에는 해당 처리를 전환하는 등급별 명령(/fast, /ultrafast)이 제공되며(더 빠른 응답, 플랜 사용량 증가), 이미지를 보내기 전에 비전 지원이 확인되고, 제공자가 허용하는 경우 요청은 프롬프트 캐싱을 지원합니다.