EasyMint: 내장 Pi Agent를 갖춘 오픈 소스 데스크톱 AI 코딩 플랫폼

English | 简体中文

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/appicon-dark.png" /> <img src="https://raw.githubusercontent.com/tianemon/EasyMint/HEAD/assets/appicon-light.png" width="128" alt="EasyMint" /> </picture> </p> <h1 align="center">EasyMint</h1> <p align="center"> <strong>내장 Pi Agent를 갖춘 오픈 소스 데스크톱 AI 코딩 플랫폼입니다.</strong> </p> <p align="center"> <a href="https://github.com/tianemon/EasyMint/releases"><img src="https://img.shields.io/github/v/release/tianemon/EasyMint?style=flat-square&color=16a34a" alt="Version" /></a> <img src="https://img.shields.io/badge/Pi%20Coding%20Agent-1.3.0-blue?style=flat-square" alt="Pi Coding Agent" /> <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" /> </p>

---

개요 (Overview)

EasyMint는 내장 Pi Agent를 갖춘 오픈 소스 데스크톱 AI 코딩 플랫폼입니다. Pi Coding Agent가 코딩 엔진을 제공하며, EasyMint는 그래픽 인터페이스, 다중 에이전트 협업 기능, 그리고 요구사항부터 배포까지의 프로젝트 가이드를 추가합니다.

이는 두 종류의 사용자를 지원합니다:

• 초보자 (Beginners): 안내받는 대화(guided conversations)를 통해 요구사항을 수집하고 프로토타입 및 기술 계획을 확정할 수 있습니다. 대화와 선택을 통해 개발을 진행합니다.
• 개발자 (Developers): 다중 에이전트 협업, 세션 관리, 그리고 크로스 디바이스 마이그레이션을 일상적인 AI 코딩 작업 공간으로 활용합니다.

프로젝트는 언제든지 전환할 수 있는 두 가지 방식으로 시작할 수 있습니다:

• 대화로 시작하기 (Start with a conversation): 아이디어를 직접 설명하면, Mint가 안내된 워크플로우를 통해 누락된 세부 정보를 채워줍니다. 또한 가이드를 건너뛰고 AI가 사용자의 설명만으로 작업하도록 할 수도 있습니다.
• 폼으로 시작하기 (Start with a form): 이름, 사용 사례(use case), 기능(features), 스타일, 예산(budget)을 제공합니다. Mint는 대화에서 열려 있는 질문들을 후속적으로 처리합니다.

EasyMint를 사용해야 하는 이유 (Why EasyMint)

코드를 작성하는 것은 사용 가능한 소프트웨어를 제공하는 일부일 뿐입니다. 요구사항, 프로토타입, 기술적 결정, 그리고 수락 검사에도 주의가 필요합니다. EasyMint는 이러한 단계를 하나의 데스크톱 애플리케이션으로 통합했습니다: 요구사항 명확화, 인터랙티브 프로토타입 생성, 기술 계획 확정, 그리고 승인된 프로토타입과 결과 비교 확인입니다.

• 코딩 경험을 가정하지 않는 가이드: 7가지 단계(gates)가 의도, 범위, 프로토타입, 사용자 승인, 기술 계획, 개발, 그리고 승인된 프로토타입에 대한 수락 검사를 다룹니다. 각 단계에는 확인 지점이 있습니다.

• 재사용 가능한 프로젝트 지식: 배운 교훈은 Markdown 형식으로 저장되며, 기술 스택별로 선택되어 프로젝트 규칙과 함께 세션 전반에 걸쳐 재사용됩니다.

• 로컬 데이터: 프로젝트 파일 및 세션 기록은 ~/.easymint/와 프로젝트의 .easymint/ 디렉토리에 보관됩니다. 장치 간 마이그레이션은 전체 패키지 검증을 사용하는 암호화된 로컬 네트워크 전송을 사용합니다. 계정이나 원격 측정(telemetry) 기능이 없습니다. 대화를 시작할 때, 프롬프트, 프로젝트 컨텍스트, 코드, 명령어 출력, 이미지는 구성한 AI 제공업체로 직접 전송됩니다. 자세한 내용은 PRIVACY.md를 참조하십시오 (중국어).

• 격리된 개발 환경: 표준 모드(Standard mode)는 의존성, 캐시, 임시 파일을 프로젝트별 런타임으로 리디렉션합니다. 명령어는 운영체제 샌드박스 내부에서 실행됩니다: macOS에서는 Seatbelt, Linux에서는 bubblewrap, 그리고 Windows에서는 전용 샌드박스 계정을 사용합니다. 네트워크 액세스는 도메인 화이트리스트를 사용하며, 적격한 개별 브라우저 및 컨테이너 명령어는 호환성 면제(compatibility exemptions)를 사용할 수 있습니다. git push는 표준 모드에서 SSH 에이전트를 사용할 수 있습니다. 호스트 자격 증명이 필요한 gh와 같은 도구는 전체 액세스(Full access)가 필요할 수 있습니다. 검사(inspection)를 위해 읽기 전용 모드(Read-only mode)도 제공됩니다. 전체 액세스는 OS 샌드박스 없이 실제 환경을 사용하며, 위험한 시스템 작업은 실행 전에 최선의 노력으로 확인 절차를 거칩니다.

• 모델 및 도구 선택: 제공업체 프리셋과 사용자 지정 OpenAI 또는 Anthropic 호환 엔드포인트 사이를 전환할 수 있으며, 지원되는 경우 계정 로그인이나 API 키를 사용할 수 있습니다. Claude Code, Codex, GitHub Agent Skills 생태계의 스킬은 물론 MCP 플러그인도 재사용할 수 있습니다.

이를 통해 다음과 같은 이점을 얻을 수 있습니다:

1. 아이디어부터 실행 가능한 소프트웨어까지의 경로: Mint는 요구사항 정의, 프로토타이핑, 기술 계획 및 승인 과정을 안내합니다. 구현이 시작되기 전에 상호작용하는 프로토타입을 확인할 수 있습니다.
2. 교체 가능한 제공업체 및 도구: 가격, 속도 제한 또는 제공업체가 변경되어도 워크플로우를 교체할 필요가 없습니다. 기존 스킬과 호환되는 MCP 구성은 재사용할 수 있습니다. 업그레이드 노트는 CHANGELOG.md (중국어)에서 확인하세요.
3. 이식 가능한 데이터: 로컬 저장소, 장치 간 마이그레이션, 그리고 MIT 라이선스는 기기 및 버전 간 이동과 소스 코드 검사를 가능하게 합니다.

EasyMint는 인라인 코드 완성 기능만 필요하거나, 프로젝트 안내 없이 CLI를 선호하거나, 여러 사람이 동일한 클라우드 호스팅 세션 및 문서에서 협업해야 하는 경우 적합하지 않을 수 있습니다. 이 플랫폼은 클라우드 협업 기능을 제공하지 않습니다.

주요 기능

• 대화형 프로젝트 가이드(Conversational project guidance): 채팅 또는 양식을 통해 프로젝트를 생성합니다. 의도, 범위, 프로토타입, 사용자 승인, 기술 계획(기능성, 현재 연구 및 비용 확인), 개발, 그리고 승인된 프로토타입 대비 수용의 7단계 게이트가 포함됩니다.

• 프로토타입 우선(Prototypes first): 중간 이상의 복잡성을 가진 프로젝트는 개발에 앞서 내장 디자이너 에이전트와 브랜드 라이브러리로부터 상호작용 가능한 HTML 프로토타입을 받습니다.

• 다중 에이전트 협업(Multi-agent collaboration): 프로젝트 관리, 코딩, 평가 및 디자인 에이전트가 작업 완료 시까지 협력합니다.

• 서브에이전트 위임(Subagent delegation): 연구, 코드 탐색 및 분석을 위임하고, 세부 내용으로 메인 대화를 채우지 않으면서 요약본을 받습니다. 진행 상황과 결과물이 표시됩니다.

• 권한 모드(Permission modes): 읽기 전용(Read-only), 표준(Standard)(기본값), 전체 액세스(Full access)가 있습니다. 표준 모드는 개발 환경을 격리하고 OS 샌드박스와 네트워크 허용 목록(allowlist)을 적용합니다. 전체 액세스는 위험 확인 후 호스트 환경을 사용합니다.

• 기술 스킬 상호 운용성(Skill interoperability): Claude Code, Codex, GitHub Agent Skills에서 스킬을 발견하고 재사용할 수 있습니다.

• Pi 확장 상호 운용성(Pi extension interoperability): 사용자 및 프로젝트 범위에서 네이티브 Pi 확장을 발견합니다. 승인된 확장은 새로운 전체 액세스 세션에서 사용 가능하며, 원래 설정과 파일은 그대로 유지됩니다.

• 경험 보존(Experience retention): 활성화하면 Mint는 작업 후 유용한 교훈을 기록합니다. 항목은 편집하거나 삭제할 수 있으며 기술 스택에 의해 재사용될 수 있습니다.

• 컨텍스트 관리(Context management): 컨텍스트 사용량을 모니터링하고, 임계값에서 압축 여부를 확인하며, 필요 시 압축을 중단시킬 수 있습니다.

• 이슈 추적(Issue tracking): 이슈를 기록하고 편집하며, 상태를 업데이트하고 Mint가 목록을 처리하도록 할 수 있습니다.

• 세션 관리(Session management): 여러 탭과 창, 세션별 활동 상태, 아카이빙 및 복원 기능을 제공합니다.

• 실행 패널(Run panel): 프로젝트 스크립트를 감지하고 실행, 중지, 재시작, 편집 및 삭제할 수 있습니다. 포트를 모니터링하고 ANSI 색상 로그를 볼 수 있습니다.

• 입력 기록(Input history): 사이드 서랍에서 이전 프롬프트를 검색하고 원래 메시지로 이동할 수 있습니다.

• 고정된 노트 (Pinned notes): 중요한 AI 출력을 크기 조절 가능한 플로팅 노트로 고정하여 세션 내내 유지할 수 있습니다.

• 로컬 소유권 (Local ownership): 프로젝트 및 세션 데이터는 사용자의 장치에 저장됩니다. PRIVACY.md에서 제공업체 요청, 에이전트 기능, 자격 증명(credential) 저장 방식에 대해 설명합니다 (중국어).

• 크로스 디바이스 마이그레이션 (Cross-device migration): 동일한 LAN의 장치를 검색하고 한 번 페어링하면 파일 선택 및 무시 규칙을 통해 프로젝트와 이전 세션을 전송할 수 있습니다. 수신 장치는 각 전송을 확인합니다. 암호화 및 패키지 검증 기능이 전송을 보호하며, 전송이 중단되어도 부분적으로 가져온 프로젝트는 남지 않습니다.

스크린샷 (Screenshots)

스크린샷은 중국어 인터페이스를 보여줍니다.

| 메인 창 (Main window) |
|---|---|
|

Main window |

멀티 에이전트 협업 (Multi-agent collaboration)

• Mint (프로젝트 관리자): 요구 사항을 이해하고 작업을 task.json으로 분해하며, 에이젠트를 조정하고 진행 상황을 추적합니다.
• Builder (코딩): 작업을 구현하고 테스트를 실행하며 문제를 수정합니다. TDD(Test-Driven Development)를 지원합니다.
• Evaluator (승인): 결과를 요구 사항과 비교하여 확인하고, 개정이 필요한 경우 미완성된 작업을 반환합니다.
• Mint-D (UI 디자인): 브랜드 라이브러리와 디자인 가이드라인을 사용하여 HTML 프로토타입을 생성합니다.
• 일반 서브 에이전트 (General subagents): 유형 탐색(typed exploration), 검토, 구현 작업을 처리하며, 요약본을 메인 세션에 반환합니다.

작업 진행 상황은 패널에서 확인할 수 있습니다. 역할별 작업은 할당된 템플릿을 사용하고, 일반 작업은 표준 서브 에이전트를 사용합니다. 위임 깊이(Delegation depth)와 작업 유형은 제어할 수 있습니다.

권한 및 보안 (Permissions and security)

EasyMint는 실행 전에 명령어를 확인합니다. 표준 모드와 읽기 전용 모드는 운영체제(operating-system) 강제 적용도 합니다. 세 가지 범주가 경계를 정의합니다:

• 시스템 코어(System core): 모든 모드에서 시스템 디렉터리, 원시 장치(raw devices), 그리고 csrutil, spctl, fdesetup과 같은 디스크 또는 보안 메커니즘은 차단됩니다.
• 위험한 작업(Dangerous operations): 권한 상승(sudo / doas), 시스템 서비스 변경, 그리고 MCP 설정, 시작 디렉터리, EasyMint 모델/프로바이더 설정 등 코드를 실행할 수 있는 영구적인 구성은 모든 모드에서 차단됩니다.
• 일반 리소스(Ordinary resources): 읽기 전용(Read-only) 및 표준(Standard) 모드는 프로젝트 작업 공간, 런타임, 시스템 임시 디렉터리로의 리소스 접근을 제한하며, 민감한 자격 증명 접근은 차단됩니다. 전체 접근(Full access)은 일반 작업 공간 제약을 해제합니다.

Pi 확장은 명시적으로 승인된 메인 프로세스 코드이며 전체 접근(Full access) 세션에서만 로드됩니다. 확장 초기화 및 이벤트 핸들러는 일반 도구 샌드박스를 통과하지 않습니다. 표준 또는 읽기 전용으로 전환할 때, 현재 응답은 완료될 수 있으며, 확장 도구는 즉시 중지되고, 유휴 상태가 되면 새로운 권한으로 세션이 재구성됩니다.

모드는 다음과 같이 다릅니다:

• 읽기 전용 (Read-only): 승인된 읽기 도구만 일반 프로젝트 콘텐츠에 사용할 수 있도록 허용합니다. 알 수 없는 도구, 명령어, 파일 및 애플리케이션 상태 변경, MCP(Machine Context Protocol), 네트워크 접근 및 민감한 자격 증명은 차단됩니다. 빌드, 테스트, 의존성 설치 및 Git 작업은 사용할 수 없습니다.
• 표준 (Standard) (기본값): HOME, TMPDIR, 그리고 npm/pip/cargo 캐시를 ~/.easymint/runtimes/<project>/로 리디렉션합니다. 명령어는 OS 샌드박스 내부에서 실행됩니다. 호환성 목록, 단일 명령어 예외 처리, 네트워크 허용 목록이 개발 도구를 지원합니다. open 예외 처리는 하나의 HTTP(S) URL만 수락하며, 복합 명령어, 파이프, 리디렉션 및 명령어 치환은 해당되지 않습니다. git push와 fetch는 키가 이미 로드된 경우 SSH-agent 서명을 사용할 수 있습니다. 호스트 로그인 디렉토리가 필요한 도구는 전체 접근(Full access)이 필요할 수 있습니다.
• 전체 접근 (Full access): OS 샌드박스 없이 실제 호스트 환경을 사용합니다. gh, Git, 시스템 명령어, 브라우저 및 Playwright와 같은 도구가 호스트 환경을 사용할 수 있습니다. 전환하려면 위험 확인(risk confirmation)이 필요합니다. 시스템 코어 쓰기, 권한 상승 및 영구 구성에 대한 보호는 실행 전의 최선의 노력이며, 동적 스크립트에 대한 강력한 격리는 아닙니다.
• 보수적인 사전 검사 (Conservative preflight checks): 대상 식별 경로와 권한 상승을 확인합니다. 메시지 텍스트, 정규 표현식 및 스크립트 내용은 파일 경로로 취급되지 않습니다. 커널 강제가 샌드박스 모드에서 추가 경계를 제공합니다.
• 가시적인 모드 표시기 (Visible mode indicators): 입력 카드에는 읽기 전용의 경우 자물쇠 방패, 표준의 경우 체크된 방패, 전체 접근의 경우 위험 색상의 경고 방패가 표시됩니다.