{"id":50229264,"url":"https://github.com/modu-ai/moai-studio","last_synced_at":"2026-06-12T09:01:09.401Z","repository":{"id":354038036,"uuid":"1216670916","full_name":"modu-ai/moai-studio","owner":"modu-ai","description":"Pure Rust cross-platform Agent IDE with GPUI UI, libghostty-vt terminal, SPEC-first development, and integrated MoAI-ADK orchestration. Pre-v0.1.0.","archived":false,"fork":false,"pushed_at":"2026-05-03T23:59:35.000Z","size":19561,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-04T00:26:09.414Z","etag":null,"topics":["agent-ide","agentic-coding","claude-code","cross-platform","developer-tools","gpui","libghostty","linux","macos","moai-adk","rust","spec-driven-development","terminal-multiplexer"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/modu-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-21T06:02:31.000Z","updated_at":"2026-05-03T23:59:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/modu-ai/moai-studio","commit_stats":null,"previous_names":["modu-ai/moai-studio"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/modu-ai/moai-studio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modu-ai%2Fmoai-studio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modu-ai%2Fmoai-studio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modu-ai%2Fmoai-studio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modu-ai%2Fmoai-studio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/modu-ai","download_url":"https://codeload.github.com/modu-ai/moai-studio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modu-ai%2Fmoai-studio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34236552,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-ide","agentic-coding","claude-code","cross-platform","developer-tools","gpui","libghostty","linux","macos","moai-adk","rust","spec-driven-development","terminal-multiplexer"],"created_at":"2026-05-26T18:00:25.034Z","updated_at":"2026-06-12T09:01:09.394Z","avatar_url":"https://github.com/modu-ai.png","language":"Rust","funding_links":[],"categories":["AI Tools \u0026 Agent Orchestration"],"sub_categories":[],"readme":"# MoAI Studio\n\n\u003e **moai-adk 공식 크로스플랫폼 Agent IDE.**\n\u003e SPEC-first 개발 방법론, MoAI-ADK 통합, 27개 Hook 이벤트, 26개 전문 에이전트, TRUST 5 품질 게이트, @MX 코드 어노테이션을 갖춘 고성능 네이티브 터미널 멀티플렉서.\n\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Rust](https://img.shields.io/badge/rust-1.93%2B-orange.svg)](https://www.rust-lang.org/)\n[![Pane CI](https://github.com/modu-ai/moai-studio/actions/workflows/ci-v3-pane.yml/badge.svg?branch=develop)](https://github.com/modu-ai/moai-studio/actions/workflows/ci-v3-pane.yml)\n[![Rust CI](https://github.com/modu-ai/moai-studio/actions/workflows/ci-rust.yml/badge.svg?branch=develop)](https://github.com/modu-ai/moai-studio/actions/workflows/ci-rust.yml)\n![Status](https://img.shields.io/badge/status-v0.1.1-green.svg)\n\n**저장소**: `github.com/modu-ai/moai-studio` (2026-04-26 GoosLab에서 modu-ai org로 이전)  \n**언어**: Pure Rust  \n**Edition**: Rust 2024  \n**MSRV**: Rust 1.93+  \n**라이선스**: Apache License 2.0\n\n---\n\n## 이것이 MoAI Studio입니다\n\nMoAI Studio는 **SPEC-first 개발 방법론을 구현한 크로스플랫폼 Agent IDE**입니다. Rust 기반의 고성능 엔진과 GPUI 프레임워크를 통해 GPU 가속 네이티브 UI를 제공하며, 터미널 엔진으로 libghostty-vt를 통합합니다.\n\n**핵심 특징:**\n\n- **SPEC-driven 워크플로우**: EARS 형식 요구사항, TRUST 5 품질 게이트, @MX 코드 어노테이션으로 엄격한 개발 규율 유지\n- **MoAI-ADK 통합**: Go CLI 오케스트레이션 프레임워크와 시스템 수준 협력 (Hook, Agent dispatch)\n- **고성능 Terminal**: libghostty-vt 기반 터미널 멀티플렉서로 최대 성능 + 호환성\n- **크로스플랫폼 배포**: macOS (arm64 + x86_64), Linux (x86_64), Windows (x86_64) — 부호화 및 자동 업데이트는 MS-2 예정\n\n---\n\n## 현재 상태 \u0026 로드맵\n\n| 마일스톤 | 상태 | 구현 내용 |\n|---------|------|---------|\n| **V3 Scaffold** | ✅ 완료 | 23개 Rust crate 컴파일, 기본 UI/Terminal 구조 |\n| **SPEC-V3-001~013** | 🔄 진행 중 | 핵심 Agent IDE 기능, Pane system, Terminal multiplexing |\n| **SPEC-V3-011 MS-1** | ✅ 완료 | macOS (.app), Linux (.deb + .AppImage), Windows (.msi) 패키징 infra |\n| **v0.1.0 (unsigned)** | ✅ 첫 정식 릴리스 | GitHub Releases unsigned 배포 (USER-DECISION-PK-B (b) 결정) |\n| **SPEC-V3-DIST-001** | 📅 ready (구현 예정) | Homebrew Cask + Scoop bucket + AUR + AppImage 무료 배포 채널 등록 |\n| **MS-2 (signed)** | 📅 차기 | macOS codesign + notarize, Windows EV signtool 인증 (인증서 보유 시) |\n| **MS-3 (auto-update)** | 📅 차기 | Ed25519 서명, GitHub Releases JSON manifest 기반 자동 업데이트 |\n\n---\n\n## 아키텍처 (V3)\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│              MoAI Studio (Rust + GPUI)                      │\n│                                                             │\n│   GPU-accelerated UI (gpui crate)                          │\n│       │                                                     │\n│       ▼                                                     │\n│   moai-studio-app (binary: moai-studio)                    │\n│       │                                                     │\n│       ├─ moai-studio-terminal ──────► libghostty-vt        │\n│       ├─ moai-studio-ui              (terminal subsystem)  │\n│       ├─ moai-studio-workspace                             │\n│       ├─ moai-studio-spec   ──────► .moai/specs/ parsing   │\n│       ├─ moai-studio-agent  ──────► agent dispatch         │\n│       └─ moai-studio-plugin-api ──► plugin runtime         │\n│                                                             │\n│   Foundation crates (moai-core, moai-fs, moai-git, ...)    │\n└─────────────────────────────────────────────────────────────┘\n                       │\n                       ▼ subprocess / IPC\n              moai-adk-go (Go CLI orchestration)\n```\n\n**핵심 설계:**\n\n- **Pure Rust**: 메모리 안전성, 성능, 빌드 일관성 (Swift 레거시 제거 완료)\n- **GPUI 기반**: Zed Industries의 GPU 가속 UI 프레임워크 (의존성 계획)\n- **libghostty-vt 통합**: ghostty-org의 재사용 가능한 VT 서브시스템\n- **23개 Rust crate 워크스페이스**: 모듈식 아키텍처, 각 도메인별 책임 분리\n\n---\n\n## 저장소 구조\n\n```\nmoai-studio/\n├── README.md                  ← 이 파일\n├── CHANGELOG.md\n├── LICENSE                    ← Apache 2.0\n├── Cargo.toml                 ← Rust workspace\n├── Cargo.lock\n├── crates/                    ← 23개 Rust crate\n│   ├── moai-claude-host/\n│   ├── moai-core/\n│   ├── moai-fs/\n│   ├── moai-git/\n│   ├── moai-studio-app/       ← 메인 binary (moai-studio)\n│   ├── moai-studio-ui/        ← UI layer\n│   ├── moai-studio-terminal/  ← Terminal multiplexer\n│   ├── moai-studio-workspace/\n│   ├── moai-studio-spec/      ← SPEC parsing\n│   └── ... (16 more crates)\n├── .moai/\n│   ├── specs/                 ← SPEC-V3-001~015 드래프트 및 구현\n│   ├── config/\n│   └── project/\n├── .github/\n│   ├── workflows/             ← CI/CD (Pane CI, Rust CI, Release Drafter)\n│   └── labels.yml\n├── .claude/                   ← Claude Code 설정 \u0026 rules\n│   ├── rules/moai/\n│   ├── skills/\n│   └── agents/\n├── scripts/                   ← 빌드 \u0026 배포 유틸\n│   ├── build-macos.sh\n│   ├── build-linux.sh\n│   └── build-windows.sh\n├── wix/                       ← Windows MSI 패키징\n└── archive/                   ← 이전 버전 (Swift M2 era)\n    └── swift-legacy/          ← 레거시 Xcode 프로젝트\n```\n\n**주목:**\n\n- `.moai/specs/`: EARS 형식 SPEC 문서, TRUST 5 품질 검증\n- `.github/workflows/`: macOS + Linux 매트릭스 CI, bench-smoke, Release Drafter\n- `crates/`: 23개 독립 crate — 각 crate가 명확한 책임 소유\n\n---\n\n## 빠른 시작\n\n**필수 조건**: Rust 1.93+, git, 크로스플랫폼 빌드 환경 (Cargo)\n\n### 소스에서 빌드\n\n```bash\ngit clone https://github.com/modu-ai/moai-studio.git\ncd moai-studio\ncargo build --release -p moai-studio-app\n./target/release/moai-studio\n```\n\n## 설치 방법\n\nMoAI Studio는 다양한 채널을 통해 설치할 수 있습니다. 권장되는 방법부터 순서대로 안내합니다.\n\n### 🍺 패키지 매니저 설치 (권장)\n\n#### macOS (Homebrew)\n```bash\n# Homebrew tap 추가\nbrew tap modu-ai/tap\n\n# 설치\nbrew install --cask moai-studio\n```\n\n#### Windows (Scoop)\n```bash\n# Scoop bucket 추가\nscoop bucket add moai https://github.com/modu-ai/scoop-bucket\n\n# 설치\nscoop install moai-studio\n```\n\n#### Arch Linux (AUR)\n```bash\n# yay를 사용한 설치\nyay -S moai-studio-bin\n\n# 또는 다른 AUR 헬러 사용\nparu -S moai-studio-bin\n```\n\n### 📦 직접 다운로드\n\n#### v0.1.1+ 릴리스 바이너리\n[GitHub Releases](https://github.com/modu-ai/moai-studio/releases)에서 최신 버전 다운로드:\n\n- **macOS**: `moai-studio-mac-*.dmg` (universal binary: arm64 + x86_64)\n- **Linux**: `moai-studio-linux-amd64.AppImage`\n- **Windows**: `moai-studio-windows-x64.msi`\n\n#### Linux AppImage\n```bash\n# 다운로드\nwget https://github.com/modu-ai/moai-studio/releases/latest/download/moai-studio-linux-amd64.AppImage\n\n# 실행 권한 부여\nchmod +x moai-studio-linux-amd64.AppImage\n\n# 실행\n./moai-studio-linux-amd64.AppImage\n```\n\n### 🚀 소스에서 빌드\n\n**필수 조건**: Rust 1.93+, git\n\n```bash\n# 저장소 클론\ngit clone https://github.com/modu-ai/moai-studio.git\ncd moai-studio\n\n# 빌드\ncargo build --release -p moai-studio-app\n\n# 실행\n./target/release/moai-studio\n```\n\n---\n\n## Known Limitations (v0.1.0)\n\nv0.1.0은 OS 레벨 인증서 미보유 상태로 release됩니다 (USER-DECISION-PK-B (b) 결정, 2026-04-27). 사용자는 다음 한 번의 우회 작업이 필요하며, 이후 일반 앱과 동일하게 동작합니다.\n\n### macOS — Gatekeeper quarantine 제거\n\n다운로드한 `.dmg`를 마운트하고 `moai-studio.app`을 `/Applications/`로 드래그한 후, 터미널에서 다음 명령을 한 번 실행:\n\n```bash\nxattr -dr com.apple.quarantine /Applications/moai-studio.app\nopen /Applications/moai-studio.app\n```\n\n또는 `Finder → moai-studio.app 우클릭 → \"열기\" → \"열기\"` 1회. 이후 Spotlight/Launchpad에서 일반 앱처럼 실행 가능.\n\n### Windows — SmartScreen 우회\n\n`.msi` 더블클릭 시 \"Windows protected your PC\" 경고가 표시됩니다.\n\n```\n1. 경고 화면에서 \"More info\" 클릭\n2. \"Run anyway\" 클릭\n```\n\n이후 시작 메뉴에서 일반 앱처럼 실행 가능.\n\n### Linux — 무서명 표준\n\n`.deb` / `.AppImage` 모두 별 인증 작업 없이 실행됩니다.\n\n```bash\n# Debian/Ubuntu\nsudo dpkg -i moai-studio-v0.1.0.deb\n\n# AppImage (모든 distribution)\nchmod +x moai-studio-v0.1.0.AppImage\n./moai-studio-v0.1.0.AppImage\n```\n\n### 알려진 제약사항\n\n**v0.1.0**: unsigned 배포로 인한 OS별 우회 작업이 필요합니다. 아래 내용 참조하시거나, **v0.1.1+ 로 업그레이드하여 패키지 매니저로 자동 처리**할 수 있습니다.\n\n#### macOS — v0.1.0: Gatekeeper quarantine 제거\n\n다운로드한 `.dmg`를 마운트하고 `moai-studio.app`을 `/Applications/`로 드래그한 후, 터미널에서 다음 명령을 한 번 실행:\n\n```bash\nxattr -dr com.apple.quarantine /Applications/moai-studio.app\nopen /Applications/moai-studio.app\n```\n\n또는 `Finder → moai-studio.app 우클릭 → \"열기\" → \"열기\"` 1회. 이후 Spotlight/Launchpad에서 일반 앱처럼 실행 가능.\n\n#### Windows — v0.1.0: SmartScreen 우회\n\n`.msi` 더블클릭 시 \"Windows protected your PC\" 경고가 표시됩니다.\n\n```\n1. 경고 화면에서 \"More info\" 클릭\n2. \"Run anyway\" 클릭\n```\n\n이후 시작 메뉴에서 일반 앱처럼 실행 가능.\n\n#### Linux — v0.1.0: 무서명 표준\n\n`.deb` / `.AppImage` 모두 별 인증 작업 없이 실행됩니다.\n\n```bash\n# Debian/Ubuntu\nsudo dpkg -i moai-studio-v0.1.0.deb\n\n# AppImage (모든 distribution)\nchmod +x moai-studio-v0.1.0.AppImage\n./moai-studio-v0.1.0.AppImage\n```\n\n\u003e **팁**: 패키지 매니저를 사용하면 위의 우회 작업이 필요 없습니다. **v0.1.1+ 부터는 Homebrew, Scoop, AUR에서 자동으로 설치됩니다.**\n\n---\n\n**v0.1.1+ 패키지 매니저 설치**: 패키지 매니저를 통해 설치 시 아래와 같은 이점이 있습니다:\n- 자동 서명 및 인증서 처리\n- 업데이트 알림 및 자동 업그레이드\n- 의존성 자동 관리\n- 표준 설치 경로 사용\n\n### 알려진 carry-over 제약\n\nv0.1.0은 V3 아키텍처의 minimum-viable surface로 한정됩니다. 다음 SPEC들은 v0.1.x patch 또는 v0.2.0+ backlog로 이월됩니다:\n\n- SPEC-V3-005 (File Explorer)\n- SPEC-V3-006 (Markdown / Code Viewer)\n- SPEC-V3-007 ~ 010 (Agent Dashboard, SPEC Management UI 등)\n- SPEC-V3-DIST-001 (배포 채널 등록 — 위 안내 참조)\n\n자세한 분류는 [.moai/specs/RELEASE-V0.1.0/plan.md](./.moai/specs/RELEASE-V0.1.0/plan.md) §1.2 참고.\n\n---\n\n## SPEC-driven 개발\n\nMoAI Studio는 **MoAI-ADK 프레임워크**를 통해 SPEC-first 개발을 실현합니다.\n\n**핵심 개념:**\n\n- **EARS 형식**: Ubiquitous, Event-driven, State-driven, Unwanted, Optional 요구사항 표기\n- **TRUST 5 게이트**: Tested (85%+ coverage), Readable, Unified, Secured, Trackable 품질 검증\n- **@MX 태그**: 코드 수준 어노테이션 (@MX:NOTE, @MX:WARN, @MX:ANCHOR, @MX:TODO)\n- **26개 전문 에이전트**: manager-spec, expert-backend, expert-frontend, manager-ddd, manager-tdd 등\n\n현재 구현 중인 SPEC: [.moai/specs/](https://github.com/modu-ai/moai-studio/tree/develop/.moai/specs/)\n\n**학습 자료:**\n\n- [MoAI-ADK 문서](https://github.com/modu-ai/moai-adk) (Go CLI 프레임워크)\n- [SPEC-V3-001~015](https://github.com/modu-ai/moai-studio/tree/develop/.moai/specs/)\n\n---\n\n## CI/품질 게이트\n\n모든 코드 변경은 다음 자동 검증을 거칩니다:\n\n| 검사 | 대상 | 상태 |\n|------|------|------|\n| **Fmt + Clippy** | macOS + Linux | ✅ |\n| **Cargo test** | macOS + Linux | ✅ (7 contexts required, §2.1) |\n| **Bench-smoke** | macOS + Linux | ✅ |\n| **Tmux-test** | macOS + Linux | ⏳ (--ignored 버킷, SPEC-V3-FS-WATCHER-001 pending) |\n| **Release Drafter** | PR 라벨 기반 CHANGELOG | ✅ |\n\n**Branch protection** ([CLAUDE.local.md §2](./CLAUDE.local.md#2-branch-protection-rules-hard--github-settings)):\n\n- `main`: 1개 approval + 7 required contexts (Squash merge: feature, Merge commit: release/hotfix)\n- `develop`: 7 required contexts, 0 approvals (Squash merge: feature)\n- `release/*`, `hotfix/*`: 활성화 시 main과 동일 규칙\n\n---\n\n## 기여 방법\n\n**현재**: 단일 개발자 운영 (Goos Kim, namgoos@gmail.com). 외부 기여는 허용되지만 일괄 처리될 수 있습니다.\n\n**저장소 정책:**\n\n- **branch model**: `main` (releases only) \u003c `release/*` \u003c `develop` \u003c `feature/SPEC-XXX-*` + `hotfix/*`\n- **Conventional Commits**: `feat(scope): description [AC-XXX]` + `🗿 MoAI \u003cemail@mo.ai.kr\u003e`\n- **PR base branch**: `develop` (단, hotfix는 `main`에서 분기)\n- **라벨링**: type/ + priority/ + area/ (3축 필수, .github/labels.yml)\n- **Auto-merge**: PR approval + CI GREEN 시 자동 머지 (Squash merge for feature)\n\n자세한 내용: [CLAUDE.local.md §6](./CLAUDE.local.md#6-일상-워크플로-체크리스트)\n\n---\n\n## 브랜딩 제약 (Anthropic 공식)\n\n출처: [Claude Agent SDK overview](https://code.claude.com/docs/en/agent-sdk/overview)\n\n- ✅ **허용**: \"MoAI Studio\", \"MoAI Agent IDE\", \"moai + Claude\", \"Powered by Claude\"\n- ❌ **금지**: \"Claude Code\" 명칭 사용, \"Claude Code Agent\" 명명\n- ❌ **금지**: claude.ai OAuth 로그인 구현\n- ✅ **인증**: `ANTHROPIC_API_KEY`, Bedrock, Vertex, Foundry\n\n---\n\n## 관련 저장소\n\n- [**modu-ai/moai-adk**](https://github.com/modu-ai/moai-adk) — Go CLI 오케스트레이션 프레임워크 (이 GUI의 본체)\n- [**ghostty-org/ghostty**](https://github.com/ghostty-org/ghostty) — 터미널 VT 엔진 (libghostty-vt 통합)\n- [**zed-industries/zed**](https://github.com/zed-industries/zed) — GPUI UI 프레임워크\n- [**anthropics/claude-code**](https://github.com/anthropics/claude-code) — Claude Code CLI\n\n---\n\n## 레거시 설계 문서\n\n다음 문서들은 진화 기록 및 아키텍처 결정으로 보존됩니다:\n\n- [DESIGN.md](./DESIGN.md) (v2) — 초기 아키텍처\n- [DESIGN.v3.md](./DESIGN.v3.md) (v3) — SDK 임베드 가정\n- [DESIGN.v4.md](./DESIGN.v4.md) (v4) — 공식 문서 기준 Rust + UI\n- [NEXT-STEPS.md](./NEXT-STEPS.md) — 다음 마일스톤 계획\n\nSwift M2 era의 레거시 Xcode 프로젝트는 `archive/swift-legacy/`에 보존됩니다 (참고 목적).\n\n---\n\n## 라이선스\n\n[Apache License 2.0](./LICENSE) — 자유로운 상용/개인 사용, 수정, 배포 허용.\n\nCopyright © 2026 MoAI Studio (modu-ai organization)\n\n---\n\n## 연락처\n\n- **메인테이너**: Goos Kim (namgoos@gmail.com)\n- **이슈 추적**: [GitHub Issues](https://github.com/modu-ai/moai-studio/issues)\n- **토론**: [GitHub Discussions](https://github.com/modu-ai/moai-studio/discussions)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodu-ai%2Fmoai-studio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmodu-ai%2Fmoai-studio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodu-ai%2Fmoai-studio/lists"}