<p align="center">
<img src="https://raw.githubusercontent.com/OpenCoven/coven/HEAD/assets/opencoven/opencoven.svg" alt="OpenCoven logo" width="128" height="128">
</p>
Coven
프로젝트 범위에 국한된 에이전트 세션을 위한 로컬 하네스 기질(substrate)
Codex, Claude Code, GitHub Copilot CLI 및 향후 코딩 하네스를 명시적인 로컬 프로젝트 경계 내에서 실행합니다.
하나의 중립적인 런타임 기질을 통해 에이전트 작업을 시작하고, 관찰하며, 연결하고, 조정할 수 있습니다.
MIT License
Platform
npm
Built with Rust
⚠️ 초기 MVP(Early MVP) — Coven은 활발히 개발 중인 로컬 우선(local-first) 런타임입니다. macOS, Linux 및 Windows x64에서 모험심 강한 개발자들이 사용할 수 있습니다. npm 패키지는 라이브 상태입니다. 미흡한 점이 있을 것으로 예상됩니다.
외부 PR은 열려 있습니다(External PRs are open) — 더 큰 변경 사항의 경우 이슈에서 시작하고, PR을 범위 내로 유지하며, PR 템플릿에서 요청하는 준비 패킷을 포함하십시오.
Coven이란 무엇인가?
Coven은 OpenCoven 생태계를 위한 로컬 하네스 기질입니다. 이는 Codex나 Claude Code 같은 코딩 에이전트 CLI가 프로젝트 작업이 눈에 보이고 안전하게 일어날 수 있는 공유 공간을 제공합니다.
하나의 프로젝트. 모든 하네스. 가시적인 작업.
- 사용할 도구(harness)를 선택합니다 — Codex, Claude Code, GitHub Copilot CLI 또는 향후 어댑터들.
- Coven이 세션을 소유합니다 — 프로젝트 범위 경계, PTY 실행, 이벤트 로깅, SQLite 영속성.
- 클라이언트가 작업물을 제시합니다 — CastCodes, CLI/TUI, comux 또는 동일 사용자 로컬 IPC API를 통한 자체 통합.
Rust 데몬이 권한 경계(authority boundary)입니다. 모든 클라이언트—CLI 자체도 포함하여—는 편의 레이어에 불과합니다. 보안 결정은 외부 클라이언트로 나가지 않고 항상 데몬 내부로 흐릅니다. OpenClaw는 packages/openclaw-coven 내의 선택적 @opencoven/coven 플러그인을 통해서만 통합되며, OpenClaw 코어에는 Coven 코드가 포함되어 있지 않습니다.
설치 (Install)
npm install -g @opencoven/cli
coven doctor
| 패키지 | 플랫폼 |
|---|
@opencoven/cli | 범용 래퍼 — 사용자의 플랫폼을 자동 선택함 |
| ... | |
메모리 대시보드는 npm install -g @opencoven/coven-memory-dashboard를 통해 별도로 설치하는 선택적 보조 도구입니다 (Node.js 24+); docs/reference/cli-observe.md 참조.
라우트(npm, cargo, 소스) 설치, 플랫폼 동작 방식, 서비스 관리자 및 컨테이너에 대한 문서는 **https://docs.opencoven.ai/docs/guide/install**에서 확인할 수 있습니다.
빠른 시작 (Quick start)
cd /path/to/your/project
...
순수한 coven 명령어는 대신 대화형 Coven UI를 열어줍니다 — 대화형 UI 참조. 명령어 참고 자료는 docs.opencoven.ai/docs/cli에 있습니다.
문서 (Documentation)
공개 설치, CLI, 데몬, 도구(harness), API, 메모리 및 문제 해결 문서는 **docs.opencoven.ai**에서 표준화되어 있습니다.
다음부터 시작하세요:
이 레포지토리는 소스 코드와 함께 진화해야 하는 문서만 보관합니다:
| 로컬 문서 | 여기에 남아있는 이유 |
|---|
| API 계약 | 규범적인 coven.daemon.v1 요청, 응답, 오류 및 호환성 계약 |
| ... | |
기여 (Contributing)
첫 10분 체크아웃 경로, 전체 로컬 개발 루프, PR 준비 패키지는 CONTRIBUTING.md를 참조하세요. 간단한 규칙은 다음과 같습니다:
- Rust가 권위 계층입니다. 실행(Launch), 현재 작업 디렉터리(cwd) 검증, PTY 라이프사이클, 세션 지속성 및 IPC 강제는 Rust의 책임이며, 클라이언트는 결코 신뢰 경계가 아닙니다.
- 어댑터 계약이 안정화될 때까지 하네스 지원은 Codex, Claude Code, GitHub Copilot CLI에 집중하세요.
- 문서 전용 변경 사항을 포함하여 모든 PR 제출 전에
python scripts/check-secrets.py를 실행하고, 런타임 상태(.coven/, *.sqlite*, *.sock, .env*, *.key)는 절대 커밋하지 마세요.
성능 기준선(Performance baselines)은 병합을 막지 않으면서 추세 데이터를 수집합니다:
cargo build -p coven-cli --locked
node scripts/benchmark-cli.mjs --binary target/debug/coven --iterations 3 --output /tmp/coven-perf.json
node scripts/benchmark-chaos.mjs --binary target/debug/coven --output /tmp/coven-chaos.json
둘 다 일회용 COVEN_HOME 디렉터리와 더미 하네스만 사용하며, scripts/benchmark-chaos.test.mjs는 CI에서 결정론적으로 게이팅(gates)합니다.
보안 (Security)
Coven은 1.0 미만의 소프트웨어입니다. 그에 맞게 취급하세요:
- 신뢰할 수 없는 하네스(harness)나 프롬프트는 민감한 저장소에서 실행하지 마십시오. 세션 로그는 하네스의 출력을 캡처하므로, 만약 하네스가 비밀 정보를 유출하면 Coven이 이를 기록합니다.
- 프롬프트에 비밀 정보(secrets)를 붙여넣지 마십시오. 이벤트 페이로드(Event payloads)는 API 표시 전에 마스킹되지만, 방어 깊이(defense in depth)는 프롬프트 자체에 비밀 정보를 포함하지 않는 것에서 시작됩니다.
취약점 보고: 이 저장소의 경우 GitHub Security Advisories를 사용해 주십시오. 정책은 SECURITY.md를, 공개 신뢰 경계(public trust boundary)는 Safety를 참조하십시오.
로드맵 (Roadmap)
마일스톤 원장(milestone ledger)은 docs/ROADMAP.md에 있습니다. 항목들은 설계, 구현, 테스트 및 출시 과정을 거치면서 이동합니다.
라이선스 (License)
MIT © Valentina Alexander and the OpenCoven contributors — 전체 약관은 LICENSE를 참조하십시오.
<div align="center">
OpenCoven — 하나의 프로젝트. 모든 하네스. 가시적인 작업.
</div>