Oak

이 저장소는 Oak의 오픈 소스 핵심입니다:
에이전트 속도의 버전 관리 (version control). 이 프로젝트는 Cargo 워크스페이스 (workspace)로 개발되었습니다: 재사용 가능한 VCS 라이브러리와 에이전트가 구동하는 oak 명령줄 클라이언트 (command-line client)로 구성됩니다.

사용 중인 에이전트(Claude Code, Codex, Cursor, …)를 가져오세요. Oak는 에이전트가 읽고, 쓰고, 브랜치(branch)를 만들고, 협업하는 기반이 됩니다. 이 기질(substrate)은 에이전트가 실제로 작동하는 방식에 맞춰 형성되었습니다. 즉, 작업 단위로서의 세션당 브랜치(branch-per-session), 커밋 메시지(per-commit messages)를 대신하는 브랜치 설명(branch descriptions), 그리고 에이전트가 몇 초 안에 어떤 저장소든 편집할 수 있게 하는 콘텐츠 주소 지정 방식의 레이지 마운트(content-addressed lazy mounts)를 제공합니다. 콘텐츠 주소 지정(content-addressed) 방식이며 필요할 때 수분화(hydrates)되기 때문에, 에이전트 워크로드에 대해 Git보다 훨씬 빠릅니다. 하지만 이 속도는 홍보 문구가 아니라 설계의 결과입니다.

Crate	Path	crates.io	설명
oakvcs-core	core/	oakvcs-core	VCS 기반: BLAKE3 콘텐츠 해싱 (content hashing), 콘텐츠 정의 청킹 (content-defined chunking), diff/merge, Blob/Manifest/Commit/Tree 데이터 모델, 그리고 선택적인 클라이언트 측 로컬 저장소 (SQLite + git 백엔드).
oakvcs-cli	cli/	oakvcs-cli	oakvcs-core를 기반으로 구축된 oak 바이너리 (binary).

자신의 프로젝트에서 라이브러리 사용하기

oakvcs-core는 단독으로 사용 가능합니다. 예를 들어, 다른 도구나 엔진에 Oak 통합 기능을 구축할 때 사용할 수 있습니다. 기본 기능(default features)을 끈 상태에서 콘텐츠 주소 지정 데이터 모델과 해싱(hashing)만 가져오려면 다음과 같이 설정하세요 (SQLite/git 제외):

[dependencies]
oakvcs-core = { version = "0.99.0", default-features = false }

이 크레이트(crate)는 oakvcs-core로 게시되지만, 임포트(imported)할 때는 oak_core로 합니다.

디스크 상의 Repository (SQLite + 읽기 전용 git) 백엔드도 함께 사용하려면 기본 local-repo 기능을 추가하세요.

CLI 설치하기

Oak는 퍼블릭 베타 (public beta) (v0.99.0) 단계입니다. 가장 빠르게 시작하는 방법은 미리 빌드된 oak 바이너리를 사용하는 것입니다:

curl -fsSL oak.space/install | sh

설치 프로그램은 macOS (Apple Silicon) 및 **Linux (x86_64)**를 지원합니다. 설치 후, oak upgrade를 통해 바이너리를 제자리에서 업데이트할 수 있습니다.

Windows (x86_64)

curl … | sh

설치 프로그램(installer)은 Unix 전용입니다. Windows에서는 최신 GitHub 릴리스(release)에서 사전 빌드된 oak-windows-x86_64.exe를 다운로드하여 (이름을 oak.exe로 변경한 후 PATH에 추가하세요), 또는 crates.io에서 cargo install oakvcs-cli를 통해 빌드할 수 있습니다. oak upgrade를 실행하면 제자리에서 업데이트됩니다.

Windows에서 oak mount는 선택적 Windows 기능인 **Projected File System (ProjFS)**를 사용합니다. 관리자 권한의 PowerShell에서 기기당 한 번 활성화하십시오:

Enable-WindowsOptionalFeature -Online -FeatureName Client-ProjFS -NoRestart

(또는 설정 → 앱 → 선택적 기능 → "Windows Projected File System"을 통해 설정 가능). 그 외의 모든 기능 — clone, push, pull, commit — 은 ProjFS 없이도 작동합니다.

crates.io에서 빌드하는 것을 선호하시나요? 대신 Cargo를 사용하여 설치하십시오 (macOS, Linux, Windows에서 작동하며, TLS 스택이 rustls + ring을 사용하므로 C/NASM 빌드 툴체인이 필요하지 않습니다):

cargo install oakvcs-cli # `oak` 바이너리를 빌드 및 설치합니다

소스 코드 빌드 (Building from source)

cargo build --workspace # oak-core + oak 바이너리를 빌드합니다
cargo test -p oakvcs-cli # CLI 테스트 (wiremock HTTP 테스트 포함)
make build # 릴리스 빌드 + CLI 릴리스 툴링
...

CLI는 워크스페이스 내 경로를 통해 oak-core에 의존하므로, 별도의 설정 없이 일반적인 cargo build만으로 로컬 core/ 체크아웃을 대상으로 작동합니다. 릴리스 증명 및 crates.io 게시 순서 확인에 대해서는 docs/release-readiness.md를 참조하십시오.

라이선스 (License)

Apache-2.0. LICENSE를 참조하십시오.

AI

이 저장소는 인간의 감독 하에 거의 전적으로 AI를 사용하여 작성되었습니다. 수정이 필요한 사항을 발견하거나 기여하고 싶다면 [email protected]으로 이메일을 보내거나 Discord를 통해 연락해 주세요.