sparsehive

AI 에이전트 세션 매니저. git worktree + sparse-checkout으로 파일 단위 격리 환경을 제공한다.

대규모 리포지터리에서 AI 에이전트가 필요한 파일만 노출된 독립 작업 환경을 만들어, 컨텍스트 오염 없이 병렬 작업을 수행할 수 있다.

주요 기능

• 세션 기반 격리 — git worktree로 독립된 작업 디렉터리를 생성하고, sparse-checkout으로 필요한 파일만 노출
• TUI 파일 선택 — 터미널 UI로 노출할 파일을 대화형으로 선택 (select)
• 양방향 동기화 — 세션↔원본 간 변경사항을 merge, cherry-pick, rebase, patch 전략으로 반영
• 세션 자동 인식 — 세션 디렉터리 안에서 실행하면 세션 ID를 자동 감지

설치

macOS (네이티브)

cargo build --release

Linux x86_64 크로스 컴파일 (macOS에서)

brew install filosottile/musl-cross/musl-cross
rustup target add x86_64-unknown-linux-musl
RUSTC=$(rustup which rustc) cargo build --release --target x86_64-unknown-linux-musl

사용법

# 세션 생성
sparsehive create --name my-session

# TUI로 파일 선택
sparsehive select my-session

# CLI로 파일 추가/제거
sparsehive add my-session src/main.rs src/lib.rs
sparsehive remove my-session src/lib.rs

# 파일 목록으로 일괄 적용
sparsehive apply --file paths.txt

# 세션 정보 조회
sparsehive info my-session
sparsehive info --json        # JSON 출력
sparsehive list               # 전체 세션 목록

# 세션 디렉터리에서 셸 열기
sparsehive open my-session

# 변경사항 동기화
sparsehive sync --strategy merge        # 세션→원본
sparsehive update --strategy rebase     # 원본→세션

# 세션 관리
sparsehive close my-session             # 비활성화
sparsehive reopen my-session            # 재개
sparsehive destroy my-session           # 삭제
sparsehive destroy my-session --force   # 강제 삭제

라이선스

MIT