Galpi

갈피 소개

갈피는 묻고 만드는 채팅이에요. 채팅마다 작업 공간(VM)이 생기고, 그 안에서 에이전트가 파일과 저장소를 읽고 돌려 보며 답해요.

프로젝트의 저장소를 두고 나눈 채팅. 위의 막대에서 미리보기를 열어요.프로젝트의 저장소를 두고 나눈 채팅. 위의 막대에서 미리보기를 열어요.
프로젝트의 저장소를 두고 나눈 채팅. 위의 막대에서 미리보기를 열어요.

무엇을 하나요

갈피에서는 채팅이 먼저예요. 프로젝트를 고르지 않고 파일과 대화로 바로 시작할 수 있고, 프로젝트를 고르면 그 프로젝트의 git 저장소(여럿일 수 있어요) 가운데 고른 것들을 받아서 일해요.

  • 채팅마다 작업 공간이 하나 생겨요. 채팅을 시작하면 VM이 하나 붙고, 그 안에서 opencode 에이전트가 저장소를 읽고, 명령을 돌리고, 파일을 고쳐요. 답에는 무엇을 읽고 무엇을 돌렸는지가 함께 남아요.
  • 고친 화면을 바로 열어 봐요. 저장소에 띄우는 법(.galpi/preview.yml)을 적어 두면 채팅 위에 미리보기 막대가 생기고, 테스트 계정과 함께 앱을 브라우저로 열어요. → 미리보기
  • 저장소에 올려요. 저장소마다 허용하면 에이전트가 정해 둔 브랜치로 push해요. 자격 증명은 갈피 서버에만 있어요. → 채팅에서 git push
  • VS Code로 이어서 고쳐요. 에이전트가 보는 그 작업 공간을 브라우저 VS Code나 내 컴퓨터의 VS Code로 열어요. → 코드 편집기
  • 팀의 방식을 더해요. 스킬(에이전트가 읽는 안내와 명령), MCP 연결(외부 도구), 프로젝트별 에이전트 지침으로 채팅을 맞춰요. → 스킬과 MCP

누가 쓰나요

사람 하는 일
누구나(로그인한 사람) 채팅, 파일 첨부, 공유 링크, 내 스킬과 내 연결
프로젝트 관리자 저장소 연결, 멤버 초대, 미리보기·에이전트 지침·스킬·MCP·프록시 설정, push 허용
시스템 관리자 설치와 처음 설정, VM을 돌릴 곳(노드), 모델, 로그인, 예산, 백업, 감사 기록
외부 사용자(게스트) 초대받은 프로젝트에서만 채팅. 프로젝트 없는 채팅과 push는 할 수 없어요

어떻게 생겼나요

브라우저채팅·미리보기·관리 갈피 서버계정·프로젝트·채팅 기록모델·저장소·프록시 중계비밀값은 여기에만 채팅 VM (채팅마다 하나)opencode 에이전트 · 체크아웃 · 미리보기 git 저장소GitHub·GitLab·사내 모델Anthropic·OpenAI 호환 VM을 돌릴 곳Fly Sprites · E2B 노드 · Sysbox 노드
  • VM에는 비밀값을 두지 않아요. 에이전트는 VM 안에서 무엇이든 실행하니까, 모델 키·Plane 키·CI 토큰은 서버가 쥐고 VM은 채팅마다 받은 토큰으로 서버의 중계(/internal/*)를 불러요. 저장소 자격만 clone과 업데이트에 필요한 동안 파일로 쓰고 지워요.
  • 저장소는 서버가 받아 둔 사본으로 세요. "새 커밋 N개"는 서버의 미러(DATA_DIR/mirrors)로 세고, 채팅은 업데이트로 새 커밋을 받아요.
  • 채팅은 보관했다가 되살려요. 쓰지 않는 VM은 재우고, 오래 쓰지 않은 채팅은 사본(S3)을 남기고 VM을 지워요. 다시 열면 사본으로 되살아나요.

저장소 구성

경로 내용
apps/server Hono + SQLite/PostgreSQL(Drizzle) API. 계정, 프로젝트, 저장소 자격, 스킬, 연동, 프록시, 미리보기, 채팅, VM 인증
apps/web React + Vite 웹 앱 (Catalyst 부품, Pretendard)
packages/shared 서버와 웹이 같이 쓰는 API 타입
vm/ VM에 올라가는 것: 프롬프트, opencode 설정, clone·업데이트·보관 스크립트, 작업 명령, 미리보기, 코드 편집기
node-kit/ E2B·Sysbox 노드 소프트웨어: 에지, 설치·가입·업데이트 스크립트
deploy/ Docker Compose 배포(Caddy, Forgejo, 내장 S3)

다음으로

Esc