도구별 실전 가이드 · 공식 정보 확인 2026-08-20

pi-desktop Apache-2.0 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Windows, macOS, Linux · 페이지 갱신: · 운영·편집 기준

Pi Coding Agent의 세션, 프로젝트 파일, 브라우저 도구와 플러그인을 한 데스크톱 작업공간에서 관리한다.

Pi Coding Agent의 세션, 프로젝트 파일, 브라우저 도구와 플러그인을 한 데스크톱 작업공간에서 관리한다. pi-desktop의 첫 실전 과제는 “기존 저장소를 열어 오류 재현부터 수정안 검토까지 한 세션으로 진행한다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “결제 모듈 테스트가 실패하는 원인을 찾고 수정 후보를 보여 줘” 같은 입력으로 pi-desktop의 핵심 기능을 시험하려는 사람
  • 실패 원인, 실행한 명령, 변경 파일 diff가 세션 기록에 함께 남는지 확인한다. 기준으로 pi-desktop 결과를 직접 검수할 수 있는 경우
  • Windows·macOS·Linux 환경에서 Apache-2.0 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • 데스크톱 앱 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 브라우저·셸 권한을 가진 에이전트가 승인하지 않은 파일이나 외부 계정을 조작할 수 있다.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

실패 테스트를 한 세션에서 재현하기

Pi Coding Agent 세션에 실패 로그와 실행 명령이 연결되어 원인을 다시 따라갈 수 있다.

참고 시작점: Pi Coding Agent에서 결제 모듈의 실패 테스트 하나만 재현하고 수정은 아직 제안으로 남겨 달라.

  1. project files에서 테스트 파일과 관련 구현 파일만 세션에 추가한다.
  2. sessions 기록을 켠 뒤 실패 명령을 실행해 오류 메시지와 종료 코드를 남긴다.
  3. Pi Coding Agent가 제시한 원인 후보를 실제 스택과 대조하고 파일 쓰기 전 승인을 기다린다.

격리된 worktree에서 패치 검토하기

운영 브랜치와 분리된 git-worktree에 최소 diff와 관련 테스트 결과가 남는다.

참고 시작점: git-worktree를 새로 만들고 승인한 두 파일 안에서만 수정 후보를 적용해 diff를 보여 달라.

  1. 현재 브랜치와 깨끗한 상태를 확인한 뒤 전용 git-worktree를 연다.
  2. browser tools는 끄고 패치를 적용해 변경 파일과 줄 수를 확인한다.
  3. 관련 테스트를 실행한 뒤 diff와 실패·통과 결과를 원래 sessions 기록에 연결한다.

플러그인과 브라우저 권한을 따로 잠그기

skills·plugins·browser tools가 과제에 필요한 범위만 활성화됐는지 확인한다.

참고 시작점: 결제 테스트 검토에는 읽기 전용 skills만 남기고 plugins와 browser tools의 외부 계정 접근을 막아 달라.

  1. 설치된 skills와 plugins 목록에서 이번 저장소에 필요 없는 항목을 비활성화한다.
  2. browser tools의 허용 도메인을 로컬 테스트 주소 하나로 제한한다.
  3. 세션 종료 전에 외부 메시징 호출과 승인되지 않은 project files 접근이 0건인지 로그로 확인한다.

무료 조건과 주의점

Apache-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

Apache-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

Apache-2.0 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

브라우저·셸 권한을 가진 에이전트가 승인하지 않은 파일이나 외부 계정을 조작할 수 있다.

직접 대안과 비교

  • cc-haha — 둘 다 코딩 에이전트를 git worktree에 격리해 실패 테스트를 재현하고 패치 diff를 검토할 수 있어 같은 저장소 진단 과제를 맡길 수 있다.

공식 근거와 확인일

pi-desktop 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보Pi Coding Agent의 세션, 프로젝트 파일, 브라우저 도구와 플러그인을 한 데스크톱 작업공간에서 관리한다.pi-desktop 공식 사이트
무료 조건Apache-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지Pi Coding Agent의 세션, 프로젝트 파일, 브라우저 도구와 플러그인을 한 데스크톱 작업공간에서 관리한다.공식 제품 페이지