여러 AI 코딩 CLI를 나란히 실행하기 위한 자체 호스팅 워크스페이스 구축기 (MIT, OpenCode 우선)

r/selfhosted 여러분께. 제가 이것을 만들었으니 이 점을 염두에 두고 읽어주세요. SpaceApp은 여러 AI 코딩 Command Line Interface(CLI)를 나란히 실행할 수 있는 자체 호스팅 웹 워크스페이스입니다. 각 CLI는 자체 패널에서 실행되며, 패널들은 '룸(room)' 안에 존재하고 세션은 지속되므로, 다시 돌아왔을 때도 해당 룸이 그대로 유지됩니다.

제가 이것을 만든 이유는 코딩 에이전트들을 수많은 터미널 창과 tmux 스플릿에 분산 배치하여 실행했기 때문입니다. 각 창마다 자체 로그인 정보가 있었고, 어느 폴더에 있는지에 대한 이해도 달랐습니다. 저는 이 모든 것이 제 자신의 기계에서 한곳에서 실행되고, 어떤 에이전트가 저를 기다리고 있는지 볼 수 있으며, 무엇 하나 다른 사람의 SaaS(Software as a Service)에 의존하지 않는 도구를 원했습니다. 이것은 이제 제가 하루 종일 작업하는 도구가 되었습니다.

현재 공개 설치 버전에서는 다음 11개의 AI 코딩 CLI를 지원합니다: OpenCode first: OpenAI Codex, Claude Code, Gemini CLI, Qwen Code, Kimi Code, Grok Build, DeepSeek CLI (실험적), Cursor, GitHub Copilot, 그리고 Autohand입니다. 설치 가능하다는 것과 테스트되었다는 것은 다릅니다. 공개 설치 리허설은 OpenCode를 엔드투엔드로 실행했습니다. Claude Code는 사용자가 직접 시작해야 하는 자체 설치 흐름을 가지고 있습니다.

• 룸당 최대 16개의 패널까지 지원합니다.
• 사용자 본인의 AI 계정을 사용합니다.
• 제공사들은 공식 로그인 흐름이나 마스킹된 자격 증명 필드를 통해 연결됩니다.
• 컨테이너는 기본적으로 호스트 파일 시스템에 대한 바인드 마운트(bind mount)가 없습니다. 폴더는 워크스페이스로 등록한 후에만 나타나며, 읽기 전용 마운트도 지원합니다.
• 앱 데이터의 휴대 가능하고 체크섬이 적용된 백업 기능과 PostgreSQL, 그리고 소유자 메모리까지 제공됩니다. 제공사 자격 증명, 로그인 상태, 워크스페이스 내용물 및 브라우저 프로필은 이들에서 제외됩니다.
• 텔레메트리는 선택 사항이며, 기본값은 '아니요(No)'입니다.
• MIT 라이선스가 적용되었습니다.

이것이 아닌 것: 룸들은 세션을 정리하는 것이지 보안 경계는 아닙니다. 컨테이너 분리가 적대적인 워크로드에 대한 샌드박스(sandbox)가 아닙니다. 가볍지도 않습니다. 설치 프로그램은 최소 4개의 CPU, 8 GB RAM, 그리고 15 GiB의 여유 디스크 공간을 요구합니다. 관리형 Chromium 컨테이너를 추가하는 표준 프로필은 8개의 CPU, 16 GB RAM, 그리고 25 GiB를 권장합니다. 기본적으로 자체 호스트에서만 리스닝(listening)합니다.

사용자가 직접 설치를 접근 가능하게 만들면, 휴대폰, 태블릿 또는 다른 컴퓨터에서도 접속할 수 있습니다. 새 설치에는 선택적 모듈(copilot 및 studio)이 포함되어 있지 않습니다. 이 글에서는 해당 내용을 제외합니다. 주제는 CLI 워크스페이스에 관한 것입니다.

사용 방법은 다음과 같습니다. Node.js 20.11 이상을 사용하여 다음 명령어를 실행합니다: npx --yes run-spaceapp@latest install

이는 Linux, macOS 및 Windows 11에서 실행됩니다. 복사할 compose 파일이 없습니다. 런처가 컨테이너(core API 및 웹 앱, CLI 런타임, PostgreSQL, Temporal)를 자체적으로 관리합니다. 기본 '라이트 프로필(light profile)'에는 브라우저 컨테이너가 없습니다. 표준 프로필에서는 이를 추가합니다.

준비 상태 확인(readiness checks) 후, 일회성 설정 토큰(setup token)이 첫 번째 계정을 생성하고, 사용자가 에이전트가 볼 수 있도록 등록하려는 폴더를 지정합니다. 먼저 둘러보고 싶다면, 가상의 데이터가 포함된 라이브 데모가 있습니다: https://spaceapp.dev/spaceappmock/

코드는 다음과 같습니다: https://github.com/oll4com/spaceapp

여러분에게 듣고 싶은 내용은 다음과 같습니다. 어떤 CLI들을 함께 사용하시는지, 그리고 '룸(room)'이 tmux 세션으로는 제공하지 못하는 것이 무엇인지요.
설치가 여러분의 하드웨어 또는 운영체제(OS)에서 어떤 부분에서 문제가 발생하는지.
백업 분할(백업에 포함되는 것과 제외되는 것)이 자체 호스팅 도구에서 기대하는 바와 일치하는지 여부.

댓글에서 답변드리겠습니다. 제출자: /u/ntheogr [링크] [댓글]