just-bash-harness은(는) 무엇을 하나요?
에이전틱 하네스는 just-bash + agent-skills 기반으로, 샌드박스 도구 실행, 파생된 승인 게이트, 지속 세션, 교차 세션 메모리, 저장 시 AES-256-GCM 암호화, Cloudflare Workers AI + Anthropic 제공자를 지원합니다.
개요
이 하네스는 보안과 확장성을 최우선으로 설계된 에이전틱 도구 실행 환경입니다. just-bash의 강력한 명령어 실행 능력과 agent-skills의 모듈식 스킬 관리 시스템을 결합하여, 복잡한 워크플로우를 안전하게 자동화합니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 샌드박스 도구 실행 | 각 명령어는 격리된 환경에서 실행되어 호스트 시스템 보호 |
| 파생된 승인 게이트 | 실행 전 사용자 승인을 요구하는 정책 기반 게이트 |
| 지속 세션 | 세션 상태를 유지하여 중단 없이 장기 작업 지원 |
| 교차 세션 메모리 | 다른 세션 간 컨텍스트 공유 및 재사용 |
| AES-256-GCM 암호화 | 저장 데이터에 대한 강력한 암호화 |
| Cloudflare Workers AI + Anthropic | 다중 AI 제공자 지원으로 유연한 통합 |
설치
git clone https://github.com/MauricioPerera/just-bash-harness.git
cd just-bash-harness
npm install
환경 변수
| 변수명 | 설명 | 기본값 |
|---|---|---|
JUST_BASH_HARNESS_API_KEY | API 인증 키 | 없음 |
CLOUDFLARE_API_TOKEN | Cloudflare Workers AI 토큰 | 없음 |
ANTHROPIC_API_KEY | Anthropic API 키 | 없음 |
SESSION_ENCRYPTION_KEY | AES-256-GCM 암호화 키 | 없음 |
사용법
기본 실행
just-bash-harness --config config.yaml
설정 파일 예제 (config.yaml)
sandbox:
enabled: true
timeout: 30000
memory_limit: "512mb"
authorization:
gates:
- type: "derived"
policy: "require-approval"
timeout: 60000
sessions:
persistence: true
max_sessions: 10
memory:
cross_session: true
type: "aes-256-gcm"
providers:
- cloudflare:
model: "@cf/meta/llama-3-8b-instruct"
endpoint: "https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/"
- anthropic:
model: "claude-3-opus-20240229"
도구 실행 예제
# 샌드박스에서 명령어 실행
just-bash-harness run "npm test" --sandbox
# 승인 게이트가 있는 명령어
just-bash-harness run "deploy --production" --require-approval
# 교차 세션 메모리 사용
just-bash-harness session --id session-123 --memory "key:value"
보안
모든 저장 데이터는 AES-256-GCM 알고리즘으로 암호화됩니다. 키는 SESSION_ENCRYPTION_KEY 환경 변수를 통해 제공됩니다. 세션 데이터는 지속 저장소에 쓰기 전에 암호화되고, 읽을 때 복호화됩니다.
제공자 통합
Cloudflare Workers AI
Cloudflare Workers AI 제공자를 사용하면 Cloudflare의 글로벌 네트워크에서 실행되는 AI 모델에 접근할 수 있습니다. 설정에서 엔드포인트와 모델을 지정해야 합니다.
Anthropic
Anthropic 제공자는 Claude 시리즈 모델을 지원합니다. API 키는 ANTHROPIC_API_KEY 환경 변수로 설정합니다.
기여
기여는 환영합니다! 풀 리퀘스트를 열기 전에 기여 가이드라인을 확인해주세요.
라이선스
MIT