pit · pithub

AI가 같은 실수를 두 번 하지 않게 하는 교정 메모리. pit은 오픈소스 — 당신 서버에서. pithub는 그것을 2분 만에 켜고 팀·친구와 같은 원장을 읽는 곳.

claude.ai · Claude Code · Codex에 MCP 커넥터 하나를 붙이면, 당신이 AI의 제안을 거부하고 고치고 방향을 정한 순간이 기록됩니다. 다음 세션의 AI는 제안하기 전에 그 기록을 찾아봅니다. 대화 원문은 서버로 가지 않습니다 — 결정 한 건의 요약과 당신의 말 한 줄만 갑니다.

사용자 ──(제안을 거부/수정/선택)──▶ 세션의 AI ──record_decision──▶ pithub 원장 (본인만)
다음 세션의 AI ──search_my_decisions──▶ "지난주에 같은 방식을 재보고 폐기하셨습니다"

왜

• AI가 제안하고 사람이 "ㅇㅇ"으로 넘긴 결정이 코드와 문서에 쌓이는데, "왜 이렇게 했지?"에 아무도 답하지 못한다.

• 같은 교정을 세션마다, 도구마다 반복한다. Claude의 메모리는 Codex를 모르고, Codex는 Claude를 모른다.

• CLAUDE.md · AGENTS.md는 손으로 관리하는 결정 원장이고, 늘 낡아 있다.

Related MCP server: CONTINUITY

원칙

1. 원문은 나가지 않는다. 결정의 요약과 인용문만 저장한다. 수신 시점에 시크릿·개인정보를 가린다.

2. 기본은 비공개. 기록은 본인만 본다. 팀·친구·공개는 확인한 결정만, 결정마다 골라서.

3. 기록에 드는 노력은 0. 확인은 쓰는 순간(열람·공개)에만, 품질은 주간 표본으로 잰다.

4. 지우면 정말 사라진다. 결정 하나든 계정 전체든.

5. 트윈은 묻는 사람이 볼 수 있는 결정만큼만 안다. 경계는 프롬프트가 아니라 행 접근 권한(RLS)이다.

구성

호스팅된 pithub 쓰기

1. 도구에 커넥터를 추가한다 — claude.ai: 설정 → 커넥터 → 커스텀 커넥터 · Claude Code: claude mcp add --transport http pithub <MCP URL> · Codex: Settings → MCP servers

2. GitHub로 로그인한다.

3. 끝. 평소처럼 일하면 된다. 웹의 정리함에는 봐 둘 만한 것만 온다.

팀: 웹에서 팀을 만들고 GitHub 아이디로 초대한다(본인이 수락). 팀 저장소에 팀 커넥터 주소 …/t/<팀>/mcp를 .mcp.json으로 커밋해 두면, 그 저장소에서 일하는 팀원의 결정은 아무것도 고르지 않아도 팀 범위로 기록되고, 각자 확인한 것만 팀에 보인다. 팀원의 AI는 search_my_decisions로 팀 원칙과 서로의 확정된 결정을 찾는다.

직접 돌리기 (셀프호스트)

필요한 것: Python 3.11+ · uv · Postgres(Supabase 권장) · GitHub OAuth App · HTTPS 주소(claude.ai 커넥터 요건).

git clone https://github.com/playidea-lab/pit.git && cd pit
uv sync --extra server

# 1. DB — Supabase 프로젝트를 만들고 마이그레이션 적용
cd pithub/supabase && supabase link --project-ref <ref> && supabase db push && cd ../..

# 2. MCP 서버 — 환경변수로만 설정한다 (코드에 주소·비밀 없음)
export PITHUB_GITHUB_CLIENT_ID=… PITHUB_GITHUB_CLIENT_SECRET=…   # OAuth App, 콜백 https://<서버>/auth/callback
export PITHUB_MCP_BASE_URL=https://<서버> PITHUB_JWT_SIGNING_KEY=$(openssl rand -hex 32)
export PITHUB_SUPABASE_URL=https://<ref>.supabase.co PITHUB_SUPABASE_SERVICE_KEY=…
export PITHUB_OAUTH_STORAGE_DIR=/data/oauth PITHUB_OAUTH_STORAGE_KEY=<Fernet 키>   # 재배포해도 로그인 유지
uv run python -m pit.server            # 또는 Dockerfile · fly.toml

# 3. 웹
cd pithub/web && cp .env.example .env.local   # Supabase URL·anon 키·MCP 주소
npm ci && npm run build && npm start

Supabase Auth의 GitHub provider에 같은 OAuth App을 넣고, OAuth App에 Supabase 콜백 URL을 추가한다. 서버는 Supabase 없이도 뜨지만 그때는 기록 도구가 "저장소 준비 중"을 돌려준다.

로컬 CLI pit (선택, 개발자용)

원문 보존과 감사를 원하는 사람만. Claude Code 세션 원문을 개인 보관함(~/.pit)에 지워지지 않게 복사하고, 원문에서 추출한 결정과 MCP가 기록한 결정을 대조해 기록 누락률·판정 일치율을 잰다.

uv tool install git+https://github.com/playidea-lab/pit.git
PITHUB_URL=https://<서버> pit setup     # 보관함 초기화, 첫 sync, 커넥터 명령 안내
pit login                               # 웹 설정에서 발급한 토큰
pit pull && pit audit mcp               # MCP 기록 감사

개발

uv sync --extra server
uv run ruff check pit tests && uv run pytest -q          # 단위 (200+)
docker run -d --name db -e POSTGRES_PASSWORD=x -p 55432:5432 postgres:17
PITHUB_TEST_DATABASE_URL=postgresql://postgres:x@127.0.0.1:55432/postgres uv run pytest -m integration   # RLS
cd pithub/web && npm ci && npm run lint && npm run build

테스트는 합성 데이터만 쓴다. 실제 세션 기록을 테스트에 넣지 않는다.

기여할 자리

• 소스 어댑터 — Codex, Gemini, Cursor 세션 기록 파서. pit/vault/sources.py의 SourceAdapter와 pit/transcripts/events.py의 EVENT_BUILDERS에 등록하면 보관·추출·감사가 그대로 돈다.

• 검색 순위·원칙 압축 — docs/PIT_KNOWLEDGE_DESIGN.md의 단계별 착수 조건을 따른다.

라이선스

AGPL-3.0-or-later. 이 코드로 호스팅 서비스를 제공하면 그 변경도 공개해야 합니다.