<p align="center">
<strong>简体中文</strong>
·
<a href="README.en.md">English</a>
·
<a href="README.ja.md">日本語</a>
·
<a href="README.ko.md">한국어</a>
</p>
<h1 align="center">Pier</h1>
<p align="center">
<strong>여러 AI 터미널이 켜져 있는데, 당신의 시선이 필요합니다.</strong><br />
Claude Code나 Codex는 원래 터미널에 있습니다. 파일을 수정하고 Git을 확인하는 작업도 바로 옆에서 진행됩니다.
</p>
<p align="center">
<a href="https://pier.codes">공식 웹사이트</a> ·
<a href="https://github.com/runloom/pier/releases">다운로드</a> ·
<a href="docs/README.md">문서</a> ·
<a href=".pier/canvases/pier-cli-user-manual/README.md">CLI 매뉴얼</a> ·
<a href="CONTRIBUTING.md">기여</a> ·
<a href="CHANGELOG.md">변경 로그</a>
</p>
현재 데스크톱 버전은 macOS (Apple Silicon / Intel)만 지원합니다.
왜 Pier인가요
원래의 터미널입니다. 또 다른 채팅 창이 아닙니다. 계정이나 구독을 옮기지 않습니다. Claude Code, Codex, OpenCode는 각자의 터미널에서 계속 실행됩니다.
당신이 볼 수 있도록 기다리는 곳입니다. 실행 중이고, 당신의 처리가 필요하거나 오류가 발생한 세션들이 한곳에 모여 보입니다. 탭을 넘길 필요 없이 클릭 한 번으로 원래 터미널로 돌아갈 수 있습니다.
파일 수정과 Git 작업도 별도의 창이 필요 없습니다. 파일을 열어 코드를 수정하고, 파일이나 코드 블록 단위로 임시 저장(stash), 커밋, 푸시를 진행합니다. 일상적인 한 줄 수정이나 Git 처리를 위해 다른 에디터로 전환할 필요가 없습니다.
핵심 워크플로우
- 프로젝트 또는 Git 작업 트리에서 Claude Code, Codex 또는 기타 명령줄을 엽니다.
- 여러 세션이 동시에 실행될 때, 누가 실행 중인지, 누가 당신의 처리를 기다리는지, 누가 오류가 발생했는지 한눈에 파악합니다.
- 해당 항목을 클릭하여 원래 터미널로 돌아가 확인하거나 계속 작업을 진행합니다.
- 터미널은 여전히 실행되고 있습니다. 파일을 열어 수정하고, diff를 확인한 후 커밋합니다.
핵심 기능
- 네이티브 터미널 — 프로젝트 또는 작업 트리 내에서 Shell 및 명령줄 프로그래밍 에이전트를 실행합니다. 인터페이스가 다시 로드된 후에도 실행 중인 터미널은 계속 사용할 수 있습니다.<br />
- 세션 상태 — 실행 중이고, 당신의 처리가 필요하거나 오류가 발생한 세션을 한 곳에서 확인하고 클릭하여 해당 터미널로 돌아갈 수 있습니다.<br />
- 다른 작업, 분리된 디렉토리 — 각 작업을 위한 독립적인 프로젝트 디렉토리(Git 작업 트리)를 제공하여 파일 수정 간의 영향을 받지 않습니다.<br />
- 파일, 편집 및 Git — 프로젝트 파일을 열고 편집할 수 있습니다. diff를 검토하고, 파일 또는 코드 블록 단위로 임시 저장하며, 커밋, 푸시, 브랜치, 스태시 등의 작업을 명령 팔레트에서 완료할 수 있습니다.<br />
- Canvas — 프로젝트와 함께 저장된 페이지는 바로 사용할 수 있습니다. 터미널과 상태를 조합하여 대시보드를 만들거나 실행 그래프(run diagram)를 그릴 수 있으며, 이 기능은 현재 개발 중입니다.<br />
- 저장 가능한 레이아웃 — 탭, 분할 화면, 플로팅 패널을 사용하여 터미널, 에디터, 변경 사항 등을 구성하고, 레이아웃이 자동으로 저장됩니다.
기타 기능
- 프로젝트 내용 미리보기 — Markdown, 이미지 및 기타 지원되는 프로젝트 파일을 미리 볼 수 있습니다.<br />
- 로컬 CLI —
pier를 사용하여 프로젝트를 열고, 창과 패널을 지정하며, 터미널을 열어 텍스트나 키 입력을 보내거나 에이전트와 작업 트리를 조회할 수 있습니다. 오직 로컬에서 실행 중인 Pier에만 연결됩니다.<br />
- 플러그인 — 이제 내장 플러그인과 공식 서명, 검증, 버전 관리 기능을 갖춘 플러그인을 사용할 수 있습니다. 향후 더 많은 출처가 지원될 예정이며, 현재 설치 범위는
docs/plugins.md를 참조하세요.
제품 경계
애플리케이션 자체에는 작업 대장이나 자동 스케줄러 기능이 포함되어 있지 않습니다. 대시보드나 실행 그래프를 사용하려면 터미널과 상태를 Canvas에서 조합해야 하며, 이 부분은 아직 개발 중입니다.
채팅 창 형태로 만들지 않았습니다. 나간 후에도 원래의 명령줄, 계정, 저장소는 정상적으로 작동합니다.
설치
릴리스 버전 사용하기
GitHub Releases에서 Apple Silicon 또는 Intel용 최신 macOS 버전을 다운로드하세요. Pier를 열고 프로젝트 폴더를 선택하면, 터미널 내에서 에이전트를 실행하고 파일을 탐색하며 변경 사항을 검토할 수 있습니다.
릴리스 버전이 시작되면, 디렉토리가 쓰기 가능할 경우 pier가 PATH에 설치되도록 시도합니다. 또한 설정 → 터미널에서 설치하거나, /Applications/Pier.app/Contents/Resources/bin/pier를 직접 실행하거나, CLI 매뉴얼을 따라 해당 디렉토리를 현재 터미널의 PATH에 추가할 수 있습니다.
소스 코드 실행
Node.js ^24.15.0, pnpm >=11.12.0, Xcode Command Line Tools, Homebrew 및 [email protected]가 필요합니다. 저장소는 packageManager를 통해 pnpm 11.18.0으로 잠겨 있습니다.
git clone https://github.com/runloom/pier.git
cd pier
pnpm bootstrap
...
Git 작업 트리가 처음 진입했을 경우, 먼저 pnpm setup:worktree를 실행합니다. 종속성 검사, 일반적인 문제 및 빌드 방식은 docs/development.md를 참조하세요.
로컬 CLI
정식 설치 패키지에 포함된 pier는 애플리케이션이 실행되지 않았을 때 먼저 시작됩니다. CLI는 원격 API가 아니라 로컬 Pier를 제어하는 데 사용됩니다.
pier status --json
pier . --json
pier panels list --json
자주 사용하는 명령어, 개발 모드 호출 방식 및 상태 의미론은 CLI 사용자 매뉴얼을 참조하세요.
문서
기여
Issue와 Pull Request를 제출해 주십시오. 시작하기 전에 CONTRIBUTING.md를 읽어보세요. 소규모 문서 수정 외에는, 기여가 병합되기 전에 기여자 승인이 필요합니다.
제출 전에 다음을 실행하세요:
보안 및 권한 부여
보안 문제는 SECURITY.md에 따라 비공개로 보고해 주시고, Issue를 공개적으로 제출하지 마십시오.