Galpi

프로젝트와 저장소

프로젝트를 만들고, git 저장소를 잇고, 멤버를 초대하고, 프로젝트 관리에서 채팅의 환경을 정해요.

프로젝트는 저장소 연결 여럿과 멤버, 그리고 그 채팅들이 쓸 설정의 묶음이에요. 로그인한 사람은 누구나 프로젝트를 만들 수 있어요(시스템 관리자가 정책에서 바꿀 수 있어요). 역할은 둘이에요: **관리자(owner)**와 멤버.

프로젝트 만들기

계정 메뉴의 프로젝트 관리 → 새 프로젝트, 또는 /projects/new예요. 네 단계를 거쳐요.

  1. 프로젝트 — 이름, 설명, 멤버도 push할 수 있게 할지, 이 프로젝트를 쓸 수 있는 사람(멤버만 / 로그인한 모두 / 게스트 포함), 모델.
  2. 저장소 — 저장소 페이지 주소를 붙여 넣고 접근 방식을 골라요. 저장하면 갈피가 바로 접속해 보고 기본 브랜치와 최신 커밋을 보여 줘요.
  3. 멤버 — 이메일로 초대해요. 나중에 해도 돼요.
  4. 시작 — 바로 채팅을 시작하거나 설정을 더 해요.
새 프로젝트의 첫 단계.새 프로젝트의 첫 단계.
새 프로젝트의 첫 단계.

저장소 자격

방식 언제
공개 저장소 누구나 볼 수 있는 저장소. 키가 필요 없어요
비공개 저장소 · 연결 키 HTTPS 액세스 토큰. 읽기 권한만 있는 키를 권해요
고급 · SSH 배포 키(갈피가 만든 키를 저장소에 등록) 또는 올린 SSH 키. 처음 연결할 때 호스트 키를 스캔해 보여 주고 저장해요. 바뀌면 clone이 멈추고 다시 수락해야 해요
빈 저장소로 시작 갈피 안 저장소(Forgejo)를 켰을 때. README만, 웹 화면(Vite + React), Node API, Python 같은 시작 틀을 골라요

자격은 그 저장소 것이고 서버에만 있어요. clone과 업데이트 동안만 VM의 비공개 폴더에 쓰고 끝나면 지워요. 사내 CA나 자체 서명 인증서를 쓰는 HTTPS 저장소는 인증서를 올려 믿게 할 수 있어요.

프로젝트 관리

/manage/<프로젝트>의 왼쪽 목록은 이렇게 묶여 있어요. 관리자만 보는 탭(개요, 에이전트 지침, 연결 키, 활동)이 있어요.

묶음 탭 정하는 것
개요 질문 수, 토큰, VM 시간, 저장 공간과 날마다의 질문
프로젝트 일반 · 에이전트 지침 · 멤버 이름과 권한, 이 프로젝트의 모든 채팅에 붙는 지침, 초대와 공개 범위
저장소와 실행 저장소 · 미리보기 저장소 연결과 push 규칙, 미리보기·코드 편집기·작업 공간 크기
연동 서비스 Mothership · 연동 서비스 시스템 관리자가 붙인 Mothership·나루가 있을 때만 보여요
고급 모델 · 연동 · MCP · 프록시 · 연결 키 · 스킬 프로젝트 모델, Plane·CI 연동, MCP 연결, 비밀값을 쥔 프록시, 채팅에 넣을 비밀값, 켤 스킬
기록 활동 누가 무엇을 바꿨는지
프로젝트 관리 → 개요.프로젝트 관리 → 개요.
프로젝트 관리 → 개요.
프로젝트 관리 → 저장소. 저장소마다 연결 상태와 push 설정이 있어요.프로젝트 관리 → 저장소. 저장소마다 연결 상태와 push 설정이 있어요.
프로젝트 관리 → 저장소. 저장소마다 연결 상태와 push 설정이 있어요.

프록시와 연결 키

사내 API처럼 키가 필요한 곳은 프록시로 둬요. 갈피 서버가 키를 붙여 대신 부르고, VM에는 프록시 주소만 가요. "미리보기 앱에도"를 켜면 미리보기 앱도 그 프록시를 받아요. 연결 키는 채팅에 꼭 넣어야 하는 비밀값(각자의 키 포함)이에요. 각자의 키는 계정 메뉴의 내 연결 키에서 넣어요.

멤버와 공개 범위

멤버 탭에서 이메일로 초대하고, 멤버마다 push를 켜고, 프로젝트를 쓸 수 있는 사람을 정해요.

공개 범위 들어올 수 있는 사람
멤버만(기본) 초대받은 멤버
로그인한 모두 갈피에 로그인한 사람 누구나 스스로 들어와 써요(게스트 빼고)
게스트 포함 위에 더해 외부 사용자도. 시스템 설정에서 게스트 초대를 켰을 때만 골라요
프로젝트 관리 → 멤버.프로젝트 관리 → 멤버.
프로젝트 관리 → 멤버.
  • 범위를 넓히면 초대받지 않은 사람도 홈의 "공개 프로젝트"에서 가입하기를 눌러 멤버가 돼요. 가입하기 전에는 목록에만 보여요. 가입한 사람은 초대받은 멤버와 같고, 자기 채팅은 자기만 봐요. push는 "멤버도 코드를 올릴 수 있게" 설정을 따르고 게스트는 올릴 수 없어요.
  • 멤버 탭에 "막은 사람"과, 가입이 필요해지기 전부터 쓰던 사람이 보여요. 멤버로 초대하거나, 막거나, 다시 허용해요. 멤버에서 뺀 사람은 공개여도 다시 들어오지 못해요.
  • 범위를 좁히면 더는 들어올 수 없는 사람의 채팅은 보관되고, 그 사람이 열면 "이제 멤버만 쓸 수 있어요"라고 알려 줘요.
  • 시스템 관리자는 시스템 관리 → 설정 → 공개 프로젝트 허용을 꺼서 모든 프로젝트를 멤버만 쓰게 할 수 있어요.

에이전트 지침

에이전트 지침 탭의 글은 이 프로젝트의 모든 채팅에서 에이전트가 읽어요. 코드 규칙, 테스트 명령, 고치면 안 되는 곳 같은 것을 적어요. 모든 채팅에 붙는 지침은 시스템 관리자가 AGENT_PROMPT(또는 서버 안 파일 AGENT_PROMPT_FILE)로 정해요.

Esc