Galpi
프로젝트와 저장소
프로젝트를 만들고, git 저장소를 잇고, 멤버를 초대하고, 프로젝트 관리에서 채팅의 환경을 정해요.
프로젝트는 저장소 연결 여럿과 멤버, 그리고 그 채팅들이 쓸 설정의 묶음이에요. 로그인한 사람은 누구나 프로젝트를 만들 수 있어요(시스템 관리자가 정책에서 바꿀 수 있어요). 역할은 둘이에요: **관리자(owner)**와 멤버.
프로젝트 만들기
계정 메뉴의 프로젝트 관리 → 새 프로젝트, 또는 /projects/new예요. 네 단계를 거쳐요.
- 프로젝트 — 이름, 설명, 멤버도 push할 수 있게 할지, 이 프로젝트를 쓸 수 있는 사람(멤버만 / 로그인한 모두 / 게스트 포함), 모델.
- 저장소 — 저장소 페이지 주소를 붙여 넣고 접근 방식을 골라요. 저장하면 갈피가 바로 접속해 보고 기본 브랜치와 최신 커밋을 보여 줘요.
- 멤버 — 이메일로 초대해요. 나중에 해도 돼요.
- 시작 — 바로 채팅을 시작하거나 설정을 더 해요.


저장소 자격
| 방식 | 언제 |
|---|---|
| 공개 저장소 | 누구나 볼 수 있는 저장소. 키가 필요 없어요 |
| 비공개 저장소 · 연결 키 | HTTPS 액세스 토큰. 읽기 권한만 있는 키를 권해요 |
| 고급 · SSH | 배포 키(갈피가 만든 키를 저장소에 등록) 또는 올린 SSH 키. 처음 연결할 때 호스트 키를 스캔해 보여 주고 저장해요. 바뀌면 clone이 멈추고 다시 수락해야 해요 |
| 빈 저장소로 시작 | 갈피 안 저장소(Forgejo)를 켰을 때. README만, 웹 화면(Vite + React), Node API, Python 같은 시작 틀을 골라요 |
자격은 그 저장소 것이고 서버에만 있어요. clone과 업데이트 동안만 VM의 비공개 폴더에 쓰고 끝나면 지워요. 사내 CA나 자체 서명 인증서를 쓰는 HTTPS 저장소는 인증서를 올려 믿게 할 수 있어요.
프로젝트 관리
/manage/<프로젝트>의 왼쪽 목록은 이렇게 묶여 있어요. 관리자만 보는 탭(개요, 에이전트 지침, 연결 키, 활동)이 있어요.
| 묶음 | 탭 | 정하는 것 |
|---|---|---|
| 개요 | 질문 수, 토큰, VM 시간, 저장 공간과 날마다의 질문 | |
| 프로젝트 | 일반 · 에이전트 지침 · 멤버 | 이름과 권한, 이 프로젝트의 모든 채팅에 붙는 지침, 초대와 공개 범위 |
| 저장소와 실행 | 저장소 · 미리보기 | 저장소 연결과 push 규칙, 미리보기·코드 편집기·작업 공간 크기 |
| 연동 서비스 | Mothership · 연동 서비스 | 시스템 관리자가 붙인 Mothership·나루가 있을 때만 보여요 |
| 고급 | 모델 · 연동 · MCP · 프록시 · 연결 키 · 스킬 | 프로젝트 모델, Plane·CI 연동, MCP 연결, 비밀값을 쥔 프록시, 채팅에 넣을 비밀값, 켤 스킬 |
| 기록 | 활동 | 누가 무엇을 바꿨는지 |




프록시와 연결 키
사내 API처럼 키가 필요한 곳은 프록시로 둬요. 갈피 서버가 키를 붙여 대신 부르고, VM에는 프록시 주소만 가요. "미리보기 앱에도"를 켜면 미리보기 앱도 그 프록시를 받아요. 연결 키는 채팅에 꼭 넣어야 하는 비밀값(각자의 키 포함)이에요. 각자의 키는 계정 메뉴의 내 연결 키에서 넣어요.
멤버와 공개 범위
멤버 탭에서 이메일로 초대하고, 멤버마다 push를 켜고, 프로젝트를 쓸 수 있는 사람을 정해요.
| 공개 범위 | 들어올 수 있는 사람 |
|---|---|
| 멤버만(기본) | 초대받은 멤버 |
| 로그인한 모두 | 갈피에 로그인한 사람 누구나 스스로 들어와 써요(게스트 빼고) |
| 게스트 포함 | 위에 더해 외부 사용자도. 시스템 설정에서 게스트 초대를 켰을 때만 골라요 |


- 범위를 넓히면 초대받지 않은 사람도 홈의 "공개 프로젝트"에서 가입하기를 눌러 멤버가 돼요. 가입하기 전에는 목록에만 보여요. 가입한 사람은 초대받은 멤버와 같고, 자기 채팅은 자기만 봐요. push는 "멤버도 코드를 올릴 수 있게" 설정을 따르고 게스트는 올릴 수 없어요.
- 멤버 탭에 "막은 사람"과, 가입이 필요해지기 전부터 쓰던 사람이 보여요. 멤버로 초대하거나, 막거나, 다시 허용해요. 멤버에서 뺀 사람은 공개여도 다시 들어오지 못해요.
- 범위를 좁히면 더는 들어올 수 없는 사람의 채팅은 보관되고, 그 사람이 열면 "이제 멤버만 쓸 수 있어요"라고 알려 줘요.
- 시스템 관리자는 시스템 관리 → 설정 → 공개 프로젝트 허용을 꺼서 모든 프로젝트를 멤버만 쓰게 할 수 있어요.
에이전트 지침
에이전트 지침 탭의 글은 이 프로젝트의 모든 채팅에서 에이전트가 읽어요. 코드 규칙, 테스트 명령, 고치면 안 되는 곳 같은 것을 적어요. 모든 채팅에 붙는 지침은 시스템 관리자가 AGENT_PROMPT(또는 서버 안 파일 AGENT_PROMPT_FILE)로 정해요.