RepoPrompt CE
CI
License: Apache 2.0
Platform: macOS 26+
컨텍스트 엔지니어링을 위한 무료 오픈 소스 네이티브 macOS 앱 및 에이전트 오케스트레이터입니다.
RepoPrompt CE는 코딩 에이전트가 행동하기 전에 코드베이스를 이해하도록 돕습니다. 파일, CodeMaps, 리포지토리 구조, Git diff에서 집중적이고 검토 가능한 컨텍스트를 조합하여 AI 도구 및 CLI 에이전트에 전달합니다.
또한 RepoPrompt CE는 번들된 MCP 서버 주변에 에이전트 하네스(agent harness)를 구축합니다. MCP와 호환되는 클라이언트 및 CLI 에이전트를 연결하여 리포지토리를 검색하고, 파일을 검사하며, 컨텍스트를 큐레이션하고, 에이전트 세션을 실행하며, 공유된 네이티브 macOS 인터페이스를 통해 작업을 오케스트레이션할 수 있습니다.
시작하기
다음 설정 경로 중 하나를 선택하세요. Xcode를 열 필요는 없습니다.
Homebrew로 설치하기
서명 및 공증(notarized)된 공개 앱의 경우, 전용 RepoPrompt CE Homebrew tap을 사용하세요:
brew tap repoprompt/repoprompt-ce
brew install --cask repoprompt-ce
이 명령어는 repoprompt/homebrew-repoprompt-ce tap에서 /Applications/RepoPrompt CE.app을 설치합니다. 이 cask는 repoprompt/repoprompt-ce-updates에서 프로모션된 공개 업데이트 ZIP 파일을 사용하며, 소스(source)로부터 빌드하지 않습니다. 소스 빌드 경로는 기여자 및 로컬 개발을 위해 아래에 남아 있습니다.
로컬에서 빌드하고 실행하기
개발 및 빠른 평가를 위해 Finder에서 Launch RepoPrompt CE.command를 더블 클릭하세요.
런처는 Python 3을 요구하며, 조정된 개발자 데몬(coordinated developer daemon)을 통해 RepoPrompt CE를 빌드하고, 디버그 앱을 열며, 재빌드, 상태 확인 및 중지 제어를 위한 작은 터미널 창을 유지합니다. 라이프사이클 액션이 정확한 디버그 실행 파일 경로를 검증하기 때문에 비조정적(uncoordinated)인 no-Python 대체 방안은 제공하지 않습니다. 이 런처는 명시적인 호환 가능한 DEVELOPER_DIR을 보존하거나, 시스템 전체의 xcode-select 설정을 변경하지 않고 설치된 전체 Xcode를 런처 프로세스에 사용합니다.
디버그 런처는 사용 가능한 Apple Development: 서명 ID를 사용합니다. Mac에 해당 ID가 없다면, 터미널에서 명시적인 ad-hoc 서명을 사용하여 동일한 디버그 앱을 실행하세요:
ALLOW_ADHOC_SIGNING=1 ./conductor app relaunch
ad-hoc 디버그 빌드는 인메모리 보안 저장소(in-memory secure storage)를 사용하므로, 저장된 API 키나 보안 권한 변경 사항은 실행 간에 지속되지 않습니다. 영구적인 디버그 Keychain 저장을 위해서는 안정적인 Apple Development ID를 명시적으로 전달하세요:
SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" ./conductor app relaunch
/Applications 아래의 안정적인 로컬 서명 앱을 사용하려면, 아래의 로컬 프로덕션 설치 프로그램을 사용하세요. 이 프로그램의 자체 서명 ID는 디버그 런처의 Apple Development 서명 경로와 별개입니다.
참고: 디버그 앱을 사용하여 RepoPrompt CE 자체를 수정하는 경우, 앱을 실행하거나 라이브 스모크 체크(live smoke checks)를 수행하는 검증 흐름은 이를 재빌드하고 다시 시작할 수 있습니다. 해당 검사가 실행되는 동안 디버그 앱이 재시작될 것을 예상하세요.
| Key | Action |
|---|
r | Rebuild and relaunch |
| ... | |
로컬 프로덕션 빌드 설치
/Applications 아래의 릴리스 모드 앱을 위해, Python 3을 설치하고 Finder에서 Install RepoPrompt CE Local Production.command를 더블클릭하세요. Finder 런처는 조정된 개발자 데몬을 사용합니다.
설치 프로그램은 소스에서 RepoPrompt CE를 빌드하고 전용 자체 서명 인증서를 사용하여 기존의 /Applications/RepoPrompt CE.app을 교체합니다. 이 인증서는 사용자의 Mac에서만 신뢰됩니다. macOS는 사용자에게 인증서 승인을 요청할 수 있습니다.
이를 위해서는 전체 Xcode 설치가 필요하며, 시스템 전체 xcode-select 설정을 변경하지 않고도 호환되는 설치된 Xcode를 선택하여 설치 과정을 진행합니다.
결과로 생성된 앱은 로컬 전용입니다. 이 앱은 Notarize(공증)되지 않았으므로 다른 Mac으로 복사하거나 재배포해서는 안 됩니다.
소스 빌드 요구 사항
- macOS 26 이상
- Xcode 26 — 전체
Xcode.app이어야 하며, Command Line Tools만으로는 부족합니다. RepoPrompt CE와 그 의존성(dependencies)은 @Entry 및 #Preview Swift 매크로를 사용하는데, 이 플러그인들(SwiftUIMacros, PreviewsMacros)은 Xcode.app에 포함되어 제공됩니다. 번들된 macOS 26 SDK가 SDK 요구 사항을 충족합니다. 빌드하기 전에 도구 체인을 확인하려면 ./Scripts/doctor.sh를 실행하세요.
Xcode에서 개발하기
다음 명령어를 사용하여 일회용 기여자 작업 공간(disposable contributor workspace)을 생성하고 엽니다:
Xcode 26.3에서는 패키징된 디버그 앱은 RepoPrompt CE App, 조정된 MCP 실행 파일은 RepoPrompt CE MCP, 테스트는 RepoPrompt CE Tests를 사용합니다. 테스트 스킴(test scheme)은 RepoPromptMCP가 실행 파일 전용 SwiftPM 타겟이기 때문에 conductor에 위임됩니다. Xcode는 또한 네이티브 RepoPrompt 및 repoprompt-mcp 제품 스킴도 노출합니다.
생성, 검증, 정리 및 워크플로우 경계에 대한 자세한 내용은 docs/architecture/xcode-workspace.md를 참조하세요. 릴리스 패키징은 변경되지 않으며 생성된 작업 공간을 사용하지 않습니다.
기능
- 컨텍스트 엔지니어링 (Context engineering): AI 모델이 실제로 필요로 하는 파일 및 리포지토리 세부 정보를 포함하여 밀도 높고 검토 가능한 프롬프트를 구축합니다.
- 코드베이스 방향성 (Codebase orientation): 파일 트리, 선택된 파일 내용, 라인 슬라이스, CodeMaps, Git diff 등을 결합합니다.
- 컨텍스트 빌더 (Context Builder): 에이전트가 리포지토리를 탐색하고, 관련 파일을 식별하며, 토큰 예산 내에서 컨텍스트를 큐레이션하도록 합니다. 장시간 실행되는 MCP 호출은 클라이언트가 진행률 토큰을 제공할 때 요청 범위 진행률 (request-scoped progress)을 노출합니다.
- 컨텍스트 컴포저 (Context Composer): 선택된 파일과 코드맵을 검토하고, 프롬프트 패키징 및 Git 컨텍스트를 구성한 다음, 에이전트 모드를 벗어나지 않고도 모델에 바로 사용할 수 있는 신선한 프롬프트를 복사합니다.
- 에이전트 오케스트레이션 (Agent orchestration): 네이티브 macOS 앱에서 CLI 기반의 코딩 에이전트를 실행하고 조정합니다. 앱 관리 워크트리 및
.worktreeinclude 로컬 파일 복사에 대해서는 docs/worktrees.md를 참조하십시오.
- MCP 서버 및 CLI 통합: 외부 MCP 호환 도구 및 CLI 에이전트를 RepoPrompt CE의 리포지토리 컨텍스트 및 에이전트 하니스에 연결합니다.
- 멀티 루트 워크스페이스 (Multi-root workspaces): 하나의 워크스페이스에서 관련 리포지토리, 패키지, 문서 폴더 전반에 걸쳐 작업할 수 있습니다.
- 검토 가능한 핸드오프 (Reviewable handoffs): 다른 모델이나 에이전트에게 보내기 전에 선택된 컨텍스트를 검사하고 다듬을 수 있습니다.
RepoPrompt CE는 RepoPrompt의 무료 오픈 소스 커뮤니티 에디션입니다. 이는 컨텍스트 엔지니어링, 에이전트 오케스트레이션 및 로컬 개발을 위한 네이티브 macOS 워크스페이스입니다.
유지 관리자들은 docs/open-source-readiness.md에서 릴리스 서명, Sparkle 메타데이터, 종속성 고정(dependency pins), 및 타사 공지를 추적합니다.
기여자 문서 (Contributor Documentation)
라이선스
RepoPrompt CE는 Apache-2.0에 따라 라이선스가 부여됩니다.
