Install
curl -fsSL https://get.cotal.ai | sh적합한 사용자
Cotal은 특정 모델 제공사에 묶이지 않고, 여러 머신에서 사용할 수 있으며, 확장 가능한 오픈 표준으로, 여러 AI agent가 함께 작동하도록 하는 것이 목표입니다. Codex, Cursor, OpenCode, Gemini CLI, Windsurf 중 둘 이상을 동시에 쓰면서 같은 Agent Skills 세트를 공유하고 싶거나, 자주 머신을 바꿔 작업하면서 중간에 멈춘 workflow를 다른 호스트에서 이어 실행하고 싶다면, 이 도구가 맞습니다. Claude Code 사용자는 공식이 별도로 제공하는 cotal-skills 플러그인 형태를 사용합니다.
단일 클라이언트만 쓰고 머신을 넘나드는 작업 이어가기가 필요 없다면, 기대할 수 있는 추가 이득은 제한적입니다. 다음 정보는 공식 페이지에 없으므로, 결정 전에 미확인으로 취급하세요. 지원 운영체제와 버전 요건, 계정이나 키 필요 여부, 명확히 적합하지 않은 상황입니다. 현재 확인 가능한 경계는 이렇습니다. 설치는 사용자 home 디렉터리에 기록되며 sudo가 필요 없습니다. 이것은 보통 Unix 계열 터미널 환경을 뜻하지만 공식 명시는 없고, Windows에서 사용 가능한지는 미확인입니다.
3분 만에 첫 사용 완료하기
추천 메인 경로는 한 가지뿐입니다. 아래의 명령과 경로는 모두 공식 안내에서 옵니다.
전제 조건: 터미널에서 curl을 실행할 수 있을 것. 이 머신에 Codex, Cursor, OpenCode, Gemini CLI, Windsurf 중 하나 이상이 설치되어 있을 것(Claude Code는 이 절 끝의 설명 참고).
1단계, 공식 설치 명령을 실행합니다. 여기서 확인할 점을 먼저 분명히 하겠습니다. 이 명령은 원격 스크립트를 내려받아 shell에 넘겨 실행하고, 내용을 home 디렉터리에 기록하며, 전 과정에서 sudo가 필요 없습니다. 이 점을 받아들일 수 있을 때 Enter를 누르세요.
curl -fsSL https://get.cotal.ai | sh
2단계, 공식 안내에 따라 설치 후 설정 명령을 실행합니다. 이 명령은 기본 persona를 심고, Cotal의 Agent Skills를 ~/.agents/skills에 설치합니다.
cotal setup
3단계, 지원되는 클라이언트를 하나 열고, 저위험의 읽기 전용 작은 작업을 시작해 보세요. 예를 들어 방금 설치한 Agent Skills에 어떤 종류의 내용이 있고 각각 어떤 상황에 맞는지 agent에게 설명하게 합니다. 관찰할 수 있는 성공 신호는 다음과 같습니다. 설치 스크립트가 정상적으로 끝나고, 설정 명령이 persona 심기와 skills 설치를 마칩니다. 이 skills가 각 클라이언트 UI에 어떻게 표시되고 첫 대화가 어떻게 라우팅되는지는 공식 페이지에 설명이 없습니다.
보충 설명: Claude Code는 공식 cotal-skills 플러그인을 사용하며, 설치 세부사항은 공식 페이지에서 다루지 않습니다.
사용 사례
사례 1: 여러 클라이언트가 같은 스킬 세트 공유. 상황: Cursor와 Gemini CLI를 동시에 쓰면서 도구마다 스킬 사본을 따로 관리하고 싶지 않습니다. 방법: 위의 설치와 설정을 마친 뒤, 한 클라이언트에서 agent가 막 설치한 skills로 사소한 일을 하게 합니다. 예컨대 Cotal에서 온 능력으로 무엇을 쓸 수 있게 됐는지 요약하게 합니다. 근거: 공식은 이 다섯 클라이언트용 Agent Skills를 제공하며 ~/.agents/skills에 설치합니다. 각 클라이언트가 이 디렉터리를 어떻게 불러오고 내용이 어떻게 동기화되는지는 공식 페이지에 설명이 없으며, 확인 가능한 범위는 여기까지입니다.
사례 2: 다른 머신에서 멈춘 workflow 이어가기. 상황: 노트북에서 workflow가 절반에 종료됐고, 데스크톱에서 계속하고 싶습니다. 방법: 새 호스트에서 같은 설치를 마친 뒤, agent가 이 run을 journal에서 복원하게 합니다. 근거: 공식 설명에 따르면 workflow 실행은 매 단계를 journal에 기록하고, 멈춘 run은 어떤 호스트에서든 그 journal에서 복원할 수 있습니다. 구체적인 복원 명령과 journal 저장 위치는 공식 페이지에 없으니, 경로를 스스로 추측하지 마세요.
사용 경계
파일과 명령: 확인된 기록 지점은 두 곳입니다. 설치 스크립트가 home 디렉터리에 기록하는 것(sudo 불필요), 설정 명령이 기본 persona와 ~/.agents/skills를 기록하는 것. 그 외에 agent 실행 시 다른 파일을 읽고 쓰는지, 명령을 실행하는지, 네트워크에 접근하는지는 공식 페이지에 설명이 없습니다. 모두 미지로 취급하고, 이런 작업이 일어나지 않으리라 가정하지 마세요.
실행 환경과 클라이언트: 설치는 터미널의 curl에 의존합니다. 지원 클라이언트는 공식 목록을 기준으로 하며, 공식이 이 클라이언트만 가능하다고 명시한 것은 아니고, 다른 클라이언트 사용 가능 여부는 미확인입니다.
공식 제한과 미확인 항목: 공식 페이지는 명시적인 사용 제한을 나열하지 않습니다. 아직 확인되지 않은 핵심 정보로는 시스템 요건, 제거 방법, 실제 포함된 skills 목록, journal 저장 위치, 데이터 수집 여부가 있습니다. 사용 중 이런 빈칸을 만나면 미지로 처리하고, 공식 대신 결론을 채우지 마세요.