onecli v2.0.1 — Open-source sandboxed agent harness for teams. Giving every employee a secured personal agent.

팀을 위해 만들어진 에이전트 하네스.
기업을 위한 프로 어시스턴트. 모든 직원에게 안전하게 격리된 개인 에이전트를 제공하세요.

모든 팀원이 에이전트를 갖습니다. 샌드박스로 격리되고 하나의 게이트웨이가 보호하며, 키는 절대 외부로 나가지 않습니다.

빠른 시작

클라우드 호스팅: onecli.sh

셀프 호스팅

git clone https://github.com/onecli/onecli.git && cd onecli
pnpm install
pnpm run setup

http://localhost:10254 를 여세요

Kubernetes에서는 대신 Helm chart를 설치하세요: helm install onecli oci://ghcr.io/onecli/charts/onecli. 셀프 호스팅 가이드에서 두 가지 방법을 모두 다룹니다.

OneCLI v2란 무엇인가요?

OneCLI는 AI 에이전트를 팀으로 운영하기 위한 오픈소스 플랫폼입니다. 사람마다 에이전트를 하나씩 만들고, 각 에이전트에 필요한 접근 권한을 부여하면, 에이전트는 샌드박스에서 동작하며 자격 증명을 주입하고 정책을 적용하는 게이트웨이를 통해 라우팅됩니다.

OneCLI를 만든 이유

OneCLI는 Rust로 만들어진 AI 에이전트용 자격 증명 보관소로 시작했습니다. 대부분의 수요가 Hermes, OpenClaw, NanoClaw 같은 자율 에이전트를 운영하는 개인과 팀에서 나온다는 것을 알게 되었습니다. 사람들은 자신을 위해 실제로 일을 처리하는 에이전트를 원했지만, 두 가지가 빠져 있었습니다:

비밀 정보와 권한 관리.
그리고 팀을 위한 것 - 멀티플레이어 관리.

세상의 모든 자율 에이전트는 한 사람을 위해 만들어졌습니다. 한 사람에게는 훌륭합니다. 하지만 이를 팀 전체로 확장해야 하는 순간 복잡해집니다: 각 에이전트를 띄우고, 각 에이전트가 무엇을 할 수 있고 무엇을 할 수 없는지 정하고, 호스팅하고, 누구의 에이전트인지 추적하는 일 말입니다.

그래서 방향을 바꿔 OneCLI v2를 만들었습니다.

팀을 위해 설계됨

자격 증명 공급자 연동: 회사 IdP에서 곧바로 각 직원의 신원을 대신하여 에이전트를 프로비저닝합니다.
사람마다 하나의 에이전트: 워크스페이스의 모든 사람이 대시보드나 Slack에서 접근할 수 있는 자신만의 샌드박스 에이전트를 갖습니다.
하나의 정책, 모든 곳에 적용: 팀 정책을 한 곳에서 관리하면 워크스페이스의 모든 에이전트에 적용됩니다.
결정론적 휴먼 인 더 루프 승인: 이메일 발송, Linear 티켓 삭제, S3 버킷 비우기처럼 100% 통제가 필요한 작업은 채팅 안에서 직접 승인합니다.
공유 연결: LLM 키나 서비스 계정처럼 팀 수준에서 한 번 연결하고, 에이전트별로 부여하되 에이전트에 직접 전달되지는 않습니다.

에이전트

에이전트는 단일 프롬프트가 아니라 지속적으로 존재하는 것입니다. 에이전트에는 다음이 있습니다:

컴퓨터: 파일 시스템과 셸을 갖춘 자체 격리 샌드박스. 나가는 유일한 경로는 게이트웨이이므로, 부여한 것에만 접근할 수 있고 그 외에는 아무것도 접근할 수 없습니다.
대화: 대시보드나 Slack의 자체 페이지. 이미지와 파일도 포함됩니다. 에이전트가 작업 중일 때 보낸 메시지는 뒤에 대기하지 않고 즉시 방향을 전환시킵니다.
메모리: 에이전트가 학습한 내용은 플랫폼이 보관하므로 절대 사라지지 않습니다. 언제든 읽고 편집할 수 있습니다.
스킬: 한 번 작성하면 항상 에이전트가 사용할 수 있는 지침과 도우미.
일정: 에이전트가 향후 작업을 계획할 수 있으며, 플랫폼이 적절한 시점에 에이전트를 깨웁니다.
에이전트가 절대 보지 못하는 자격 증명: 각 에이전트는 부여한 접근 권한만 가지며, 게이트웨이가 모든 요청에서 이를 적용합니다. 또는 Bitwarden이나 1Password를 연결하여 온디맨드 주입을 사용할 수 있으며, 서버에는 아무것도 저장되지 않습니다.
자체 Slack 앱: 한 번 연결하면 자체 이름과 아바타로 채널과 DM에서 파일과 이미지와 함께 응답합니다. 에이전트를 삭제하면 그 Slack 앱도 함께 삭제됩니다.

에이전트는 자체 인프라에서 실행됩니다. 러너는 아웃바운드 전용이며 인바운드 포트를 열지 않으므로, 노트북, 홈랩, NAT 뒤의 VPC 모두 인그레스나 터널 없이 동작합니다.

아키텍처

웹 대시보드: Next.js 앱. 에이전트를 생성하고, 대화하며, 메모리와 스킬을 편집하고, 연결, 시크릿, 권한 부여를 관리합니다.
API 서버: 컨트롤 플레인. 데이터베이스, 대화 플레인, 그리고 러너가 폴링하는 작업 큐를 소유합니다.
Rust 게이트웨이: 아웃바운드 요청(HTTPS 포함, MITM 경유)을 가로채고 자격 증명을 주입합니다. 에이전트는 Proxy-Authorization 헤더를 통해 액세스 토큰으로 인증합니다.
러너: 에이전트 샌드박스를 시작, 대기, 정리합니다. 아웃바운드 전용이며 데이터베이스에 절대 접근하지 않습니다.
샌드박스 슈퍼바이저: 각 샌드박스 내부에서 실행되며, 벤더 중립적인 하네스 인터페이스를 사용하여 에이전트 런타임을 교체할 수 있습니다.
SSH 터미네이터: SSH 프런트 도어 — 단기 인증서로 ssh 연결을 종료하고, 플러그 가능한 기반 백엔드를 통해 에이전트 샌드박스로 연결합니다.
채널 어댑터: Slack 데몬으로, 에이전트당 하나의 앱입니다.
시크릿 저장소: 저장 시 AES-256-GCM 암호화, 요청 시에만 복호화되며, 호스트와 경로 패턴으로 매칭되어 헤더 또는 쿼리 파라미터로 주입됩니다.

로컬 개발

git clone https://github.com/onecli/onecli.git && cd onecli
mise install
pnpm install
pnpm dev

설정은 이게 전부입니다. pnpm dev가 필요한 모든 시크릿이 담긴 .env를 생성하고, PostgreSQL을 시작하고, 마이그레이션을 적용하고, 전체 스택을 실행합니다. 사전 요구 사항, 명령어 참조, 프로젝트 구조, 구성은 docs/development.md에 있습니다.

기여

기여를 환영합니다. 시작하기 전에 기여 가이드와 행동 강령을 읽어 주세요. 기여는 기여자 라이선스 계약의 조건에 따라 접수됩니다.

보안

취약점을 신고하려면 보안 정책을 따라 주세요. 보안 신고를 위해 공개 이슈를 열지 마세요.

라이선스

Apache-2.0이며, 한 가지 예외가 있습니다. ee/ 디렉터리에는 OneCLI Enterprise License에 따른 엔터프라이즈 기능이 있으며, 각각 해당 라이선스를 가리키는 고지가 포함되어 있습니다. 이 라이선스는 개발, 테스트, 평가 목적으로는 무료이며, 프로덕션 사용에는 구독이 필요합니다. 그 외의 모든 것은 Apache-2.0이며 상용 라이선스 없이 프로덕션에서 셀프 호스팅할 수 있습니다. 라이선스가 적용되는 경로의 권위 있는 목록은 LICENSE-ENTERPRISE에 있습니다.