CleanSlate는 에이전트, 프로젝트별 대화, 브라우저, 터미널, 파일, 변경사항 검토 기능을 한데 모은 오픈소스 AI 작업공간이다. 별도 서비스인 MuscleMemory를 연결하면 검증한 코딩 작업 절차를 재사용 가능한 기술(skill)로 저장해 다른 대화나 호환 에이전트에서 활용할 수 있다.
데스크톱 앱은 VS Code를 기반으로 한다. 내장 에이전트를 쓰거나 호환되는 외부 에이전트를 연결할 수 있으며, 대화와 나란히 에이전트의 작업을 살펴볼 수 있다. 33초 데스크톱 데모도 공개돼 있다.
작업 절차를 학습하고 공유하는 방식
MuscleMemory는 작업 중 발생한 단계와 편집, 테스트 결과, 실패한 시도를 기록한 뒤 유용한 절차를 재사용 가능한 기술로 만든다. 기술을 학습시키려면 마지막 코드 변경 뒤에 테스트가 통과해야 한다. 새 기술은 이후 별도의 테스트를 두 번 더 통과하고 사용자가 승인해야 기본적으로 다시 불러올 수 있다.
승인된 기술은 이후 비슷한 작업에서 관련 단계와 검사 방법, 주의점을 짧게 제공한다. 준비된 기술은 Claude Code나 Codex에서 사용할 수 있는 SKILL.md 파일로 내보낼 수도 있다. 예를 들어 에이전트가 설정 로딩 버그를 고치고 테스트를 통과하면, MuscleMemory는 관련 파일과 수정 사항, 테스트 명령을 학습할 수 있다. 이후의 검사와 승인을 거치면 다른 에이전트가 비슷한 버그를 다룰 때 현재 코드를 확인하면서 그 절차를 출발점으로 사용할 수 있다.
공유 범위는 같은 MuscleMemory 워크스페이스에 연결한 에이전트들이다. Codex에서 학습한 기술을 Claude Code, Cursor, CleanSlate가 불러올 수 있으며, 기술은 처음 만들어진 대화에 묶이지 않는다. 메모리는 기본적으로 로컬에서 작동하고, 네임스페이스가 공유할 워크스페이스를 정한다. 다만 MuscleMemory는 별도로 설치해야 하는 선택형 서비스다. 이 저장소의 통합은 CleanSlate 내장 데스크톱 에이전트와 CLI를 지원하며, 외부 에이전트는 각자의 MuscleMemory 연결을 사용한다. 메모리를 연결하지 않아도 CleanSlate를 사용할 수 있다. 자세한 내용은 학습 규칙과 한계를 참고하면 된다.
CleanSlate의 작업공간에는 프로젝트별 대화 관리, 기존 로컬 대화 가져오기, 대화의 표시된 맥락을 다른 에이전트로 넘기는 기능이 있다. 워크스페이스 탭에서 북마크와 방문 기록을 이용해 웹을 탐색하고, 에이전트가 실제 브라우저를 조작해 작업을 확인할 수도 있다. 파일을 열고 터미널 명령을 실행하며, VS Code 편집기로 직접 코딩할 수 있다. 작업 중 바뀐 파일과 차이점을 검토하고 생성된 결과물도 작업공간 안에서 볼 수 있다.
설치와 메모리 연결
현재 데스크톱 릴리스는 CleanSlate 1.2.0이며, macOS Apple Silicon용 DMG와 ZIP을 제공한다. 릴리스 노트 또는 최신 릴리스에서 내려받을 수 있다.
Apple Developer 계정을 갱신하는 동안 Developer ID 서명과 공증은 일시적으로 중단됐다. 새 macOS 빌드는 앱 번들을 봉인하는 애드혹 서명을 사용하므로 검증된 배포자를 식별하지 않는다. 이 때문에 macOS Gatekeeper가 실행을 막아 수동 설치가 필요할 수 있고, 서명된 기존 설치에서 자동 업데이트가 거부될 수도 있다. 빌드별 서명 상태는 릴리스 노트에서 확인해야 한다.
현재 빌드가 공증되지 않아 macOS에서 실행을 차단하면, 다운로드를 신뢰하고 위 릴리스 링크에서 받았다는 전제 아래 CleanSlate.app을 Applications 폴더로 옮겨 한 번 실행한다. 이어 시스템 설정의 Privacy & Security에서 Security 항목을 찾아 CleanSlate 메시지 옆의 Open Anyway를 선택하고, 요청받으면 인증한 뒤 Open을 눌러 실행한다. 자세한 절차는 Apple의 차단된 앱 열기 안내에 있다. Intel 기반 macOS, Windows, Linux용 빌드는 아직 배포하지 않으며, 해당 플랫폼에서는 소스에서 빌드해야 한다.
MuscleMemory는 오픈소스이며 기본적으로 로컬 서비스로 실행된다. 별도로 설치한 뒤 연결할 프로젝트에서 다음 명령을 실행한다. Python 3.12 이상과 pipx가 필요하다.
pipx install thewariend-musclememory
musclememory init
musclememory start
cd your-project
musclememory connect cleanslate
musclememory connect 명령은 호스트 설정과 SDK 모듈 설정을 출력한다. 안내에 따라 설정한 뒤 같은 터미널 환경에서 CleanSlate를 실행해야 한다. 통합은 CLEANSLATE_MUSCLEMEMORY_CONFIG와 MuscleMemory TypeScript SDK를 사용하며, CLEANSLATE_MUSCLEMEMORY_NODE_MODULE이 SDK 모듈을 지정한다. 데스크톱 앱에서 통합하려면 이 저장소에서 빌드한 앱을 해당 환경에서 실행해야 한다. 데스크톱 앱만 설치해서는 메모리가 활성화되지 않는다.
외부 에이전트와 같은 메모리를 공유하려면 사용하는 에이전트마다 다음 중 해당하는 연결 명령을 실행한다.
musclememory connect codex
musclememory connect claude
musclememory connect cursor
musclememory dashboard에서는 기록된 활동을 살펴보고 기술을 검토해 재사용을 승인할 수 있다. SDK와 실행 설정은 CleanSlate 통합 안내, 다른 에이전트 연결은 MuscleMemory 빠른 시작 안내에서 확인할 수 있다.
CLI와 SDK
데스크톱 작업공간 없이 터미널에서 같은 에이전트를 실행하려면 Node 20 이상에서 CLI를 설치한다.
npm install -g @cleanslate/cli
cleanslate
설치하지 않고 실행하는 방법도 있다.
npx @cleanslate/cli "fix the failing test"
첫 실행 때 모델 제공자 설정을 안내하며, 기능을 축소하지 않은 전체 도구 모음을 이용해 어떤 저장소에서든 작업할 수 있다. 옵션과 슬래시 명령, 세션, MCP 설정은 packages/cleanslate-cli에서 볼 수 있다. CLI 패키지 버전은 1.1.0이다.
데스크톱 작업공간과 CLI를 구동하는 런타임은 SDK로도 제공된다. 편집기에 의존하지 않으며 실행 루프, 도구 레지스트리, 편집 엔진, Node 호스트를 포함한다. 이를 사용하는 표면(surface)이 파일 시스템과 명령 실행 기능을 제공하고, 필요하면 진단 기능과 브라우저도 제공할 수 있다.
npm install @cleanslate/sdk
SDK 패키지 버전은 1.2.0이다. 자세한 내용은 packages/cleanslate-sdk를 참고하면 된다. 소스 빌드에는 Node.js 22.21.1이 필요하며, 버전은 .nvmrc에 지정돼 있다.
cd vscode-fork
npm install
npm run watch
./scripts/code.sh
에이전트와 모델 설정
CleanSlate에는 메시지마다 전환할 수 있는 두 모드가 있다. 기본 실행 모드는 파일에 대한 전체 접근 권한을 갖고 작업을 수행한다. 계획 모드는 읽기 전용으로, 파일 편집과 명령 실행은 할 수 없지만 읽기, 검색, 웹 탐색, 브라우저 조작은 가능하다. 익숙하지 않은 코드베이스를 살펴보거나 변경을 계획할 때 쓸 수 있다.
특정 모델 제공자에 종속되지 않는다. OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, xAI Grok, NVIDIA, OpenRouter 또는 OpenAI 호환 엔드포인트의 키를 직접 사용할 수 있다. 선택 사항인 CleanSlate Pro에 가입하면 관리형 모델과 더 높은 한도, 사용량 기반 크레딧을 이용할 수 있다. Pro는 필수가 아니며, 직접 키를 사용하면 계정 없이도 모든 기능을 쓸 수 있다.
에이전트는 코드베이스 전체를 읽고 검색하고 편집하며, 백그라운드에서 계속 실행되는 명령을 포함해 명령을 실행할 수 있다. 실제 브라우저로 작업을 확인하고 웹을 검색하거나 내용을 가져올 수 있으며, 설정한 MCP 서버를 호출할 수도 있다. 데스크톱 작업공간에는 로컬 임베딩용 모델이 포함된다. CLI와 SDK는 설정한 임베딩 서비스를 사용할 수 있는데, 원격 서비스를 선택하면 임베딩 대상 콘텐츠가 해당 서비스로 전송된다.
확장 프로그램은 Open VSX에서 설치한다. Visual Studio Marketplace는 Microsoft 전용이라 포크에서는 사용할 수 없다. CleanSlate는 Agent Client Protocol(ACP) 호환 로컬 에이전트를 클라이언트로 실행할 수 있다. 외부 에이전트는 각각 별도 프로세스로 실행되며, 사용자가 해당 에이전트에 직접 설정한 인증 정보를 사용한다. CleanSlate는 외부 에이전트의 계정 인증 정보를 수집하거나 저장, 중계, 재판매하지 않는다고 밝힌다.
OpenCode, Grok, Claude는 사용자의 PATH에서 검색한다. Claude 지원에는 Anthropic Claude Agent SDK용 Apache-2.0 ACP 어댑터를 사용하며, 사용자가 설치한 Claude 실행 파일을 직접 실행해 Claude 자체 인증 경계를 유지한다. Codex 지원에는 데스크톱 앱에 포함된 Apache-2.0 @agentclientprotocol/codex-acp 어댑터를 사용한다. 다른 에이전트는 사용자가 설정에서 직접 등록할 수 있으며, 설치와 라이선스 조건, 인증, 사용료는 사용자가 책임진다.
기존 대화는 Settings → General → Import chats 또는 명령 팔레트의 CleanSlate: Import Claude and Codex Chats에서 가져올 수 있다. 가져온 대화에는 프로젝트, 원래 에이전트의 세션 ID, 계정 데이터 폴더가 유지된다. .codex-account2 같은 추가 계정 폴더도 지정할 수 있다. 가져온 대화는 원래 에이전트에서 이어가거나, 에이전트 선택기에서 CleanSlate 내장 에이전트 또는 다른 에이전트로 넘길 수 있다. 넘길 때는 대화에 표시된 맥락을 전달한다. 이미 가져온 대화는 반복해서 가져오지 않으며 원본 파일은 변경하지 않는다. 개별 기록 파일은 64 MiB로 제한되고, 압축된 Codex 기록을 읽으려면 호스트에 zstd 지원이 필요하다.
CleanSlate는 Anthropic, OpenAI, xAI, OpenCode 또는 다른 외부 에이전트 제공자와 제휴하거나 이들의 보증·후원을 받지 않는다고 밝힌다. 제품명과 상표는 호환되는 제3자 서비스를 식별하기 위한 용도로만 사용한다. CleanSlate는 MIT 라이선스를 따른다. 포함된 제3자 구성요소는 각각의 라이선스를 따르며, 세부 내용은 NOTICE에 있다. 데스크톱 편집기는 Visual Studio Code를 기반으로 하며 MIT 라이선스를 적용한다. 관련 내용은 LICENSE.txt에서 확인할 수 있다. CleanSlate는 Microsoft와도 제휴하거나 보증·후원을 받지 않는다고 밝힌다.
기여는 환영하며, 절차는 CONTRIBUTING.md와 행동 강령에 안내돼 있다. 보안 문제는 SECURITY.md를 통해 신고할 수 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요