Cotal: AI 에이전트가 애플리케이션과 머신을 넘어 협업 공간을 공유하게 하는 오픈소스 pub/sub 표준

Cotal은 AI 에이전트를 위한 오픈소스 발행/구독(pub/sub) 표준으로, 서로 다른 애플리케이션과 머신에 있는 에이전트와 서비스가 하나의 협업 공간을 공유할 수 있게 해줍니다. TypeScript 구현은 NATS + JetStream 위에서 동작하며, CLI, 커넥터, 프로세스 매니저, 영속 워크플로, 관측 도구를 포함합니다.

어떤 사람에게 적합한가

• 여러 AI 에이전트가 로컬에서 애플리케이션과 머신을 넘어 협업하길 원하는 개발자나 팀, 특히 통합된 서비스 계약(설명과 호출)으로 에이전트 역량을 조합하고 싶은 경우에 적합합니다.
• 로컬에서 백그라운드 프로세스(mesh, 전달 데몬, 매니저)를 상시 구동해도 괜찮은 사용자에게 적합합니다.
• 적합하지 않은 경우: 순수 일회성 스크립트만 필요하거나, 로컬 상시 백그라운드 프로세스를 받아들일 수 없거나, 환경에 Node 22.10+이 없고(공식 curl 설치기 사용도 어렵다면) 사전에 실행 가능 여부를 먼저 확인해야 합니다. Windows 사용자의 공식 경로는 npm 설치 방식입니다.

3분 만에 첫 시도하기

권장 기본 경로는 공식 curl 설치기입니다(사용자 홈 디렉터리에 설치되며 sudo가 필요 없고, 안내식 설정을 열어줍니다):

curl -fsSL https://get.cotal.ai | sh

설치가 끝나면 로컬 환경을 시작합니다:

cotal up

cotal up은 로컬 mesh, 전달 데몬, 매니저를 백그라운드에서 시작합니다. 이후 다음을 할 수 있습니다:

• cotal spawn: 터미널에서 에이전트를 하나 엽니다.
• cotal console: 팀(에이전트) 상황을 확인합니다.

위험도가 낮은 첫 관찰 동작은 cotal console을 실행해 로컬 팀 상태를 확인하는 것입니다. 원격 쓰기 작업은 발생하지 않습니다. 로컬 스택을 중지하려면 공식 명령은 cotal down입니다.

보조 방식(공식이 명시한 것이며 기본 진입점과 병렬이 아님): Node 22.10+이 이미 있거나 Windows를 사용하는 경우 npm install -g cotal-ai를 실행한 뒤 cotal setup을 실행합니다. 설정 과정에서 스페이스(space)를 준비하고, 선택한 애플리케이션을 구성하며, default persona를 심어줍니다. 구성 적용 없이 준비만 하려면 cotal setup --configure-only를 사용할 수 있습니다.

주의: 안내식 설정은 로컬 구성(스페이스, 애플리케이션 구성, persona)을 기록합니다. 이는 로컬 상태에 대한 쓰기이며 읽기 전용 동작이 아닙니다.

사용 사례

사례 1: 로컬 팀 상태 확인. 상황: Cotal을 방금 설치했고 로컬 mesh가 시작되었는지 확인하고 싶다. 방법: 먼저 cotal up으로 백그라운드 프로세스를 시작한 뒤 cotal console을 실행한다. 기대 결과: 현재 스페이스의 팀원 표시를 볼 수 있다. 이는 확인 가능한 범위 내에서 바로 검증할 수 있는 관찰 단계입니다.

사례 2: 에이전트가 팀원에게 협업 요청하기. 상황: 터미널에서 cotal spawn으로 에이전트를 연 뒤, 새 팀원을 불러오길 원한다. 방법: Cotal이 에이전트에 노출하는 도구에는 cotal_spawn(팀원 요청)과 cotal_describe, cotal_invoke(커넥터와 권한이 허용하는 범위 내에서 서비스를 발견하고 호출하는 명령 계약)가 있습니다. 기대 결과: 에이전트가 이 도구들로 팀원 요청이나 서비스 계약 호출을 시작한다. 구체적인 출력 세부 사항은 공식 문서에 하나하나 나열되어 있지 않으며, 확인할 수 있는 것은 이 도구들의 존재와 트리거 방식입니다.

사용 경계

• 읽기/쓰기 성격: cotal up/down은 로컬 백그라운드 프로세스를 관리하고, cotal setup은 로컬 구성(스페이스, 애플리케이션 구성, persona)을 기록합니다. cotal console은 관찰류 작업입니다. 로컬 쓰기를 "읽기 전용"으로 오해하지 마세요.
• 부작용과 확인 지점: CLI는 기본적으로 사용량 텔레메트리를 전송합니다. 이는 공식이 명시한 부작용이며, 시작 전에 cotal telemetry off를 실행해 끌 수 있습니다.
• 자격 증명과 권한: 에이전트의 호출 능력은 커넥터와 권한(grants)에 따라 제한됩니다. 공식은 권한의 기본 범위를 설명하지 않으므로, 사용 전에 자신의 환경에서 확인해야 합니다.
• 아직 확인되지 않은 정보: 텔레메트리의 구체적인 데이터 내용, mesh의 네트워크 노출 범위, cotal_describe/cotal_invoke의 구체적인 반환 형식은 공식 페이지에 설명이 없어, 개인정보와 네트워크 경계를 대신 판단해줄 수 없습니다.
• 위 내용은 독립적인 보안 결론이 아닙니다. 자신의 환경에 적합한지는 위의 알려진 사항과 미지의 사항을 함께 고려해 스스로 판단하세요.