sudoprivacy/sudocode

Rust-native CLI coding agent for hackers — terminal-native, pipe-composable, scrollback-safe. Built because Claude Code chose non-coders.

What Sudo Code is

Sudo Code는 터미널(예: tmux, ssh, VS Code 통합 터미널 등)에서 대부분의 시간을 보내는 파워 유저를 위한 Rust 기반의 명령줄 AI 코딩 보조 도구입니다. Anthropic, OpenAI, xAI, Gemini 또는 호환되는 모든 제공자와 대화할 수 있지만, 특정 벤더에 종속되지 않습니다. 사용자가 직접 API 키를 제공하고, 오픈 소스인 ACP 프로토콜을 통해 통신합니다.

이 도구는 쉘 내에서 인라인으로 실행됩니다. 화면을 점유하거나 전체 화면 TUI를 열지 않으며, 일반 Unix 명령어처럼 파이프로 사용할 수 있습니다. 인터랙티브(재귀적 명령어 처리) 또는 원샷 모드로 사용할 수 있으며, 에디터, 브라우저, 기타 서비스가 제어할 수 있는 헤드리스 ACP 서버로도 제공됩니다.

Who it’s for

이상적인 사용자	적합하지 않은 사용자
터미널에서 대부분의 시간을 보내며, 에이전트의 동작을 완전히 시각화하고 싶은 엔지니어 (예: 에이전트가 조작하는 정확한 소스 라인을 읽고 싶은 경우).	마우스 클릭만으로 코딩을 도와주는 도구를 원하는 초보자.
여러 병렬 AI 작업을 관리하고, 스크립트나 파이프로 제어하고 싶은 사용자.	그래픽 UI나 "내가 답만 원해"라는 경험을 원하는 사용자.
스택을 자체 관리하고, 버전 고정, 텔레메트리 없이 작동하는 것을 원하는 팀.	도구가 내부 동작을 숨기기를 원하는 사용자.

Core design principles (what it always does)

오픈소스, MIT 라이선스 – 전체 코드베이스가 공개되어 있으며, 포크 가능합니다.
모델 독립성 – 사용자가 자신의 API 키를 제공하면, 지원되는 모든 제공자와 작동합니다.
헤드리스 우선 – 동일한 바이너리가 REPL, 원샷 CLI, ACP 서버를 모두 지원합니다.
로컬 우선 & 텔레메트리 없음 – 명시적으로 전달하지 않는 한, 프롬프트는 사용자의 기계에 머무릅니다.
인라인 전용 – 출력은 단순한 ANSI 텍스트이며, 스크롤백, tmux 패널, SSH 세션은 전혀 손대지 않습니다.
안정적이고 버전 고정된 인터페이스 – 암묵적인 업데이트 없음. Semver 보장.
모든 것이 파일 – 설정, 세션 로그(JSONL), 플러그인은 모두 파일 시스템에 존재하여 검사, awk 처리, 재실행이 쉽습니다.

What it never does

숨겨진 프리미엄 레벨이나 유료벽 없음 – 바이너리는 완전한 제품입니다.
전체 화면 TUI 없음 – 터미널 화면을 점유하지 않습니다.
내장된 멀티에이전트 대시보드 없음 – 오케스트레이션은 외부 도구(예: Sudowork 플랫폼 또는 Hydra 오케스트레이터)에 맡깁니다.
강제 자동 업데이트나 텔레메트리 없음.
폐쇄소스 벤더 락인 없음.

How it works (high‑level architecture)

CLI / REPL – scode는 인터랙티브로 시작하거나 프롬프트 문자열을 제공해 호출할 수 있으며, 일반 텍스트, JSON, 또는 스트리밍 SSE 출력을 생성합니다.
Runtime – Rust 런타임이 세션, 권한, 샌드박스, 설정을 처리합니다. 파일의 위치를 결정하는 FsBackend 구현을 로드합니다:
- StdFsBackend – 로컬 파일 시스템 (스탠드얼론 CLI).
- NexusVfsFsBackend – gRPC를 통한 원격 VFS (엣지/개발 모드).
- KernelFsBackend – 인프로세스 커널 스타일 시스템 콜 (관리형 에이전트 모드).
Tools & Plugins – bash, 파일 I/O, grep, 웹 검색 등의 내장 헬퍼에 더해, 사용자 정의 "스킬"용 플러그인 시스템이 있습니다.
Model adapters – Anthropic, OpenAI, xAI, Gemini 또는 모크 백엔드의 API로 ACP 호출을 변환하는 얇은 래퍼입니다.
ACP server – scode acp serve로 WebSocket/HTTP를 통해 에이전트를 노출하여 에디터나 웹 UI가 제어할 수 있게 합니다.

Typical usage patterns

# 인터랙티브 REPL 시작 (환경 변수에서 토큰 제공)
export CLAUDE_CODE_OAUTH_TOKEN="sk-ant-…"
scode

# 원샷, 파이프 대응 사용
scode "explain this function" | bat
scode "list failing tests" --output-format json | jq '.tests[]'

# 저장된 세션 재개 (세션은 JSONL 파일로 저장됨)
cat plan.md | scode --resume <session-id>

# 에디터 통합용 헤드리스 서버로 실행
scode acp serve --port 8080

# 빠른 건강 점검
scode doctor

Installation

원라인 스크립트 – curl …/install.sh | sh는 macOS 또는 Linux용 사전 빌드된 바이너리를 다운로드하고, SHA-256 체크섬을 검증한 후 시스템 디렉터리(또는 sudo가 사용 불가능할 경우 $HOME/.local/bin)에 설치합니다. Windows 사용자는 릴리스 페이지에서 zip 파일을 다운로드할 수 있습니다.
소스에서 – git clone … && cd sudocode/rust && cargo build --release로 ./target/release/scode를 생성합니다.

Extensibility

플러그인/스킬 – 지정된 디렉터리에 컴파일된 플러그인을 넣고 CLI에서 호출할 수 있습니다. 문서는 docs/plugins.md에 있습니다.
권한 및 샌드박스 – 에이전트가 읽기/쓰기 가능한 범위를 세밀하게 제어하는 방법은 docs/permissions-and-sandbox.md에 설명되어 있습니다.
인증 – OAuth 토큰, API 키, 프록시 등 다양한 인증 모드에 대한 자세한 내용은 docs/authentication.md에 있습니다.

Roadmap & ecosystem

Sudo Code는 다른 Sudowork 구성 요소(예: Hydra 오케스트레이터, VS Code 확장 등)가 공유 메일박스 원리(노드 VFS의 chat-with-me 스트림)를 통해 제어할 수 있는 단일 에이전트 유닛으로 위치 지정됩니다. 향후 계획(참고: sudo-code-roadmap.html)에는 Nexus VFS와의 더 깊은 통합, 풍부한 플러그인 API, 하나의 인터랙티브 세션에서 100개 이상의 에이전트를 코피로트 에이전트가 관리하는 스케일링이 포함됩니다.