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


무엇을 하나요
갈피에서는 채팅이 먼저예요. 프로젝트를 고르지 않고 파일과 대화로 바로 시작할 수 있고, 프로젝트를 고르면 그 프로젝트의 git 저장소(여럿일 수 있어요) 가운데 고른 것들을 받아서 일해요.
- 채팅마다 작업 공간이 하나 생겨요. 채팅을 시작하면 VM이 하나 붙고, 그 안에서 opencode 에이전트가 저장소를 읽고, 명령을 돌리고, 파일을 고쳐요. 답에는 무엇을 읽고 무엇을 돌렸는지가 함께 남아요.
- 고친 화면을 바로 열어 봐요. 저장소에 띄우는 법(
.galpi/preview.yml)을 적어 두면 채팅 위에 미리보기 막대가 생기고, 테스트 계정과 함께 앱을 브라우저로 열어요. → 미리보기 - 저장소에 올려요. 저장소마다 허용하면 에이전트가 정해 둔 브랜치로 push해요. 자격 증명은 갈피 서버에만 있어요. → 채팅에서 git push
- VS Code로 이어서 고쳐요. 에이전트가 보는 그 작업 공간을 브라우저 VS Code나 내 컴퓨터의 VS Code로 열어요. → 코드 편집기
- 팀의 방식을 더해요. 스킬(에이전트가 읽는 안내와 명령), MCP 연결(외부 도구), 프로젝트별 에이전트 지침으로 채팅을 맞춰요. → 스킬과 MCP
누가 쓰나요
| 사람 | 하는 일 |
|---|---|
| 누구나(로그인한 사람) | 채팅, 파일 첨부, 공유 링크, 내 스킬과 내 연결 |
| 프로젝트 관리자 | 저장소 연결, 멤버 초대, 미리보기·에이전트 지침·스킬·MCP·프록시 설정, push 허용 |
| 시스템 관리자 | 설치와 처음 설정, VM을 돌릴 곳(노드), 모델, 로그인, 예산, 백업, 감사 기록 |
| 외부 사용자(게스트) | 초대받은 프로젝트에서만 채팅. 프로젝트 없는 채팅과 push는 할 수 없어요 |
어떻게 생겼나요
- 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) |
다음으로
AI 코딩 · 코드 질문 · 채팅으로 코드 고치기 · 에이전트