NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1626 by repository stars
Latest stable
v1.14.5
Last release 20 days ago
02 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Some releases are documented
notes for 30 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
219 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Breaking Change: Users with custom configurations referencing "Alfred" should update to "MoAI"
This patch release resolves critical PATH environment variable issues affecting Claude Code native installations and completes the Alfred → MoAI rebranding. It also consolidates the architecture by removing MoAI-GO and unifying on Python.
Key Changes:
settings.json template env sectionexpert-chrome-extension.md to use standard template variablesmerger.py to preserve user custom paths during updateshook_context.py```bash
uv tool update moai-adk
moai update
moai --version ```
Claude Code 네이티브 설치 환경에서 발생하는 중요한 PATH 환경 변수 문제를 해결하고 Alfred → MoAI 리브랜딩을 완료한 패치 릴리스입니다.
주요 변경사항:
settings.json 템플릿 env 섹션에 시스템 경로 추가```bash
uv tool update moai-adk
moai update
moai --version ```
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This patch release resolves critical PATH environment variable issues affecting Claude Code native installations and completes the Alfred → MoAI rebranding. It also consolidates the architecture by removing MoAI-GO and unifying on Python.
Key Changes:
settings.json template env sectionexpert-chrome-extension.md to use standard template variables ({{HOOK_SHELL_PREFIX}})merger.py to preserve user custom paths during updateshook_context.py (check absolute paths before PATH-based lookup)outputStyle: "Alfred" → outputStyle: "MoAI".claude/output-styles/moai/alfred.md → .claude/output-styles/moai/moai.md# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
Major refactoring release migrating the entire design tooling stack from Google Stitch MCP and Figma to Pencil MCP (.pen files). This consolidation si
Major refactoring release migrating the entire design tooling stack from Google Stitch MCP and Figma to Pencil MCP (.pen files). This consolidation simplifies the design workflow and empowers expert-frontend to handle UI/UX design directly.
Key Changes:
expert-stitch agent, consolidated into expert-frontend (Expert Agents: 9 → 8)⚠️ Stitch MCP Removal: The moai-platform-stitch skill and expert-stitch agent have been removed. Projects using Google Stitch should migrate to Pencil MCP.
Migration Guide:
.stitch files with .pen filesexpert-stitch to expert-frontend.mcp.jsonexpert-frontend):
batch_design: Execute multiple insert/copy/update/replace/move/delete operationsbatch_get: Retrieve nodes by patterns or IDs in batchesget_editor_state: Determine active .pen file and user selectionget_guidelines: Design guidelines for code, tables, Tailwind, landing pagesget_screenshot: Capture visual screenshots of .pen file nodesget_style_guide: Retrieve style guides by tags or name for design inspirationget_style_guide_tags: List available style guide tagsget_variables: Extract design tokens and themes from .pen filesset_variables: Add or update variables in .pen filesopen_document: Create new or open existing .pen filessnapshot_layout: Check computed layout rectangles for node insertionfind_empty_space_on_canvas: Find empty space for new elementssearch_all_unique_properties: Recursively search node propertiesreplace_all_matching_properties: Bulk property updatesexpert-frontend.md
.pen files are JSON-based, Git-friendly, human-readable design-as-code formatmoai-platform-chrome-extension with 8 modular guidesexpert-chrome-extension for specialized developmentmoai-platform-stitch skill directory (template + local)expert-stitch agent from agent catalogexpert-frontend now handles UI/UX design directlyexpert-frontend, manager-docs, manager-spec, manager-strategymoai-domain-uiux, moai-foundation-core, moai-foundation-claudemultilingual-triggers.yaml (4 languages), CLAUDE.md, README.zh.md.mcp.json (all platforms: macOS, Windows)# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
Google Stitch MCP 및 Figma에서 Pencil MCP (.pen 파일)로 전체 디자인 도구 스택을 마이그레이션하는 주요 리팩토링 릴리스입니다. 이 통합으로 디자인 워크플로우가 단순화되고 expert-frontend가 UI/UX 디자인을 직접 처리할 수 있게 되었습니다.
주요 변경사항:
expert-stitch 에이전트 제거, expert-frontend로 통합 (전문 에이전트: 9 → 8)⚠️ Stitch MCP 제거: moai-platform-stitch 스킬과 expert-stitch 에이전트가 제거되었습니다. Google Stitch를 사용하는 프로젝트는 Pencil MCP로 마이그레이션해야 합니다.
마이그레이션 가이드:
.stitch 파일을 .pen 파일로 교체expert-stitch에서 expert-frontend로 업데이트.mcp.json에서 Stitch MCP 서버 제거expert-frontend에 14개 도구 추가):
batch_design: 여러 insert/copy/update/replace/move/delete 작업 실행batch_get: 패턴 또는 ID로 노드를 일괄 검색get_editor_state: 활성 .pen 파일 및 사용자 선택 확인get_guidelines: 코드, 테이블, Tailwind, 랜딩 페이지를 위한 디자인 가이드라인get_screenshot: .pen 파일 노드의 시각적 스크린샷 캡처get_style_guide: 디자인 영감을 위한 태그 또는 이름으로 스타일 가이드 검색get_style_guide_tags: 사용 가능한 스타일 가이드 태그 목록get_variables: .pen 파일에서 디자인 토큰 및 테마 추출set_variables: .pen 파일에 변수 추가 또는 업데이트open_document: 새 .pen 파일 생성 또는 기존 파일 열기snapshot_layout: 노드 삽입을 위한 계산된 레이아웃 사각형 확인find_empty_space_on_canvas: 새 요소를 위한 빈 공간 찾기search_all_unique_properties: 노드 속성 재귀 검색replace_all_matching_properties: 속성 일괄 업데이트expert-frontend.md에 "UI/UX Design with Pencil MCP" 섹션 추가
.pen 파일은 JSON 기반, Git 친화적, 사람이 읽을 수 있는 design-as-code 형식moai-platform-chrome-extension - 8개의 모듈식 가이드 포함expert-chrome-extension - 전문 개발용moai-platform-stitch 스킬 디렉토리 (template + local)expert-stitch 에이전트expert-frontend가 이제 UI/UX 디자인을 직접 처리expert-frontend, manager-docs, manager-spec, manager-strategymoai-domain-uiux, moai-foundation-core, moai-foundation-claudemultilingual-triggers.yaml (4개 언어), CLAUDE.md, README.zh.md.mcp.json에서 Stitch MCP 서버 (모든 플랫폼: macOS, Windows)# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Feature release adding comprehensive Chrome Extension Manifest V3 development support.
Feature release adding comprehensive Chrome Extension Manifest V3 development support.
Key Features:
expert-chrome-extension agent for specialized extension developmentNone. This is a backward-compatible feature addition.
moai-platform-chrome-extension with 8 modular guides
expert-chrome-extension for specialized developmentuv.lock for package consistency# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
Chrome Extension Manifest V3 개발을 위한 포괄적인 지원을 추가하는 기능 릴리스입니다.
주요 기능:
expert-chrome-extension 에이전트 추가없음. 하위 호환 가능한 기능 추가입니다.
moai-platform-chrome-extension - 8개의 모듈식 가이드 포함
expert-chrome-extension - 전문 개발용uv.lock 업데이트# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Bug fix release resolving statusLine command overwrite issue during moai-adk update.
Bug fix release resolving statusLine command overwrite issue during moai-adk update.
Key Fix:
_update_statusline_command() incorrectly replacing template-substituted statusLine commandsmoai-adk statusline executionNone. This is a backward-compatible bug fix.
_update_statusline_command() replaced valid template-substituted commands${SHELL} literal, not actual shell paths like /bin/zsh -l -c${SHELL} variable and login shell indicator (-l -c)build_hook_context() for command generation (same as hooks)_PATH_AUGMENT)update.py: Updated _update_statusline_command() detection and generation logic# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
moai-adk update 중 statusLine 명령 덮어쓰기 문제를 해결하는 버그 수정 릴리스입니다.
주요 수정:
_update_statusline_command()가 템플릿 치환된 statusLine 명령을 잘못 교체하는 문제 수정moai-adk statusline 실행 안정성 확보없음. 하위 호환 가능한 버그 수정입니다.
_update_statusline_command()가 유효한 템플릿 치환 명령을 교체함${SHELL} 리터럴만 허용하고 /bin/zsh -l -c 같은 실제 쉘 경로는 거부${SHELL} 변수와 로그인 쉘 표시자(-l -c) 모두 허용하도록 감지 로직 업데이트build_hook_context() 사용 (hooks와 동일)_PATH_AUGMENT 포함)update.py: _update_statusline_command() 감지 및 생성 로직 업데이트# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Critical bug fix release resolving JSON parsing failure during moai-adk update on macOS, Linux, and WSL systems.
Critical bug fix release resolving JSON parsing failure during moai-adk update on macOS, Linux, and WSL systems.
Key Fix:
moai update successfullyNone. This is a backward-compatible bug fix.
moai-adk update failed with Expecting ',' delimiter: line 9 column 55 error_PATH_AUGMENT (export PATH="$HOME/...") broke JSON when substituted into settings.json_PATH_AUGMENT (PATH values have no spaces)json_safe parameter to _substitute_variables() for JSON-aware escaping using json.dumps()_WSL_PATH_NORMALIZE with quotes correctlyhook_context.py: Simplified _PATH_AUGMENT from 'export PATH="$HOME/..."' to "export PATH=$HOME/..."processor.py: Added JSON escaping with json.dumps()[1:-1] when json_safe=Trueupdate.py: Applied JSON-safe escaping to .json filesHOOK_SHELL_PREFIX values# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
macOS, Linux, WSL 시스템에서 moai-adk update 실행 중 발생하는 JSON 파싱 실패를 해결하는 중요 버그 수정 릴리스입니다.
주요 수정:
moai update를 성공적으로 실행할 수 있음없음. 하위 호환 가능한 버그 수정입니다.
moai-adk update 실행 시 Expecting ',' delimiter: line 9 column 55 오류 발생_PATH_AUGMENT의 이스케이프되지 않은 따옴표 (export PATH="$HOME/...")가 settings.json에 치환될 때 JSON을 손상시킴_PATH_AUGMENT에서 불필요한 따옴표 제거 (PATH 값에는 공백이 없음)_substitute_variables()에 JSON 인식 이스케이핑을 위한 json_safe 파라미터 추가 (json.dumps() 사용)_WSL_PATH_NORMALIZE를 올바르게 처리hook_context.py: _PATH_AUGMENT를 'export PATH="$HOME/..."'에서 "export PATH=$HOME/..."로 단순화processor.py: json_safe=True일 때 json.dumps()[1:-1]를 사용한 JSON 이스케이핑 추가update.py: .json 파일에 JSON-safe 이스케이핑 적용HOOK_SHELL_PREFIX 값으로 검증 완료# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Experimental release introducing MoAI-GO, a high-performance Go-based CLI implementation, alongside critical UTF-8 encoding fixes for Windows compatib
Experimental release introducing MoAI-GO, a high-performance Go-based CLI implementation, alongside critical UTF-8 encoding fixes for Windows compatibility.
Key Features:
Note: MoAI-GO is experimental. Production use still relies on Python implementation.
None. All changes are backward compatible.
feat(go): Implement MoAI-GO Phase 1 - Foundation and configuration system (b36ddd66)
feat(go): Implement MoAI-GO Phase 2 - Hook system with Python compatibility (f3e75202)
feat(go): Implement MoAI-GO Phase 3 - CLI commands with direct binary paths (e47534d0)
rank, switch, worktreefeat(go): Implement MoAI-GO Phase 4 - Distribution and migration system (d61f381d)
feat: Add MoAI-GO CLI commands (rank, switch, worktree) and improve cross-platform PATH handling (05d7b7be)
fix: Add UTF-8 encoding to all hook scripts and file operations (33c0a483)
.claude/hooks/moai/*.py filesencoding='utf-8' to all file operationsfix: Resolve cross-platform hook/encoding/credential issues (#314, #316) (bf280eeb)
fix(cli): Resolve Windows UTF-8 encoding error on moai init (894abd3e)
moai init failed on Windows with UnicodeEncodeErrormoai init now works correctly on Windowsrefactor: Restructure Go module path to github.com/modu-ai/moai-adk/go (97be74a7)
revert: Undo Go module restructure (testing needed) (324097d1)
refactor: Rename moai-adk to moai (2b9bf0e1)
# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
MoAI-GO 고성능 Go 기반 CLI 구현과 Windows 호환성을 위한 UTF-8 인코딩 수정을 포함하는 실험적 릴리스입니다.
주요 기능:
참고: MoAI-GO는 실험적입니다. 프로덕션 환경에서는 Python 구현을 사용하세요.
없음. 모든 변경사항은 하위 호환됩니다.
feat(go): MoAI-GO Phase 1 - Foundation 및 구성 시스템 구현 (b36ddd66)
feat(go): MoAI-GO Phase 2 - Python 호환성을 갖춘 Hook 시스템 (f3e75202)
feat(go): MoAI-GO Phase 3 - 직접 바이너리 경로를 사용하는 CLI 명령 (e47534d0)
rank, switch, worktreefeat(go): MoAI-GO Phase 4 - 배포 및 마이그레이션 시스템 (d61f381d)
feat: MoAI-GO CLI 명령 (rank, switch, worktree) 추가 및 크로스플랫폼 PATH 처리 개선 (05d7b7be)
fix: 모든 hook 스크립트 및 파일 작업에 UTF-8 인코딩 추가 (33c0a483)
.claude/hooks/moai/*.py 파일의 UTF-8 인코딩 수정encoding='utf-8' 추가fix: 크로스플랫폼 hook/encoding/credential 이슈 해결 (#314, #316) (bf280eeb)
fix(cli): moai init의 Windows UTF-8 인코딩 오류 해결 (894abd3e)
moai init 실행 중 UnicodeEncodeError 발생moai init가 올바르게 작동refactor: Go 모듈 경로를 github.com/modu-ai/moai-adk/go로 재구성 (97be74a7)
revert: Go 모듈 구조 재구성 취소 (테스트 필요) (324097d1)
refactor: moai-adk를 moai로 이름 변경 (2b9bf0e1)
# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Nothing published for this version
Nothing published for this version
Documentation-focused release improving PyYAML dependency clarity and Agent Skills standard compliance.
Documentation-focused release improving PyYAML dependency clarity and Agent Skills standard compliance.
Key Improvements:
user-invocable to top-level skill frontmatter (Agent Skills spec)moai update command in CLAUDE.local.mdNone.
version_reader.py: Helpful ImportError with installation commandsproject.py: Same error handling patternunified_timeout_manager.py: Same error handling patternpip install pyyaml and uv run --with pyyaml optionsuser-invocable from metadata to top-level frontmatter (#313) (329f8076)
"true"/"false") to boolean (true/false)moai-adk update → moai update--with pyyaml flag purpose# Update to the latest version
claude install moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
PyYAML 의존성 명확성 개선과 Agent Skills 표준 준수를 위한 문서 중심 릴리즈.
주요 개선사항:
user-invocable 필드를 skill frontmatter 최상위로 이동 (Agent Skills 사양)없음.
version_reader.py: 설치 명령어 포함 ImportErrorproject.py: 동일한 에러 처리 패턴unified_timeout_manager.py: 동일한 에러 처리 패턴pip install pyyaml와 uv run --with pyyaml 옵션 제공user-invocable을 metadata에서 최상위 frontmatter로 이동 (#313) (329f8076)
"true"/"false")에서 불리언(true/false)으로 변경moai-adk update → moai update--with pyyaml 플래그 목적 설명# 최신 버전으로 업데이트
claude install moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Issue #310: Removed deprecated Alfred command files validation
Patch release fixing moai init validation error and hook script PyYAML dependency issue.
Key Fixes:
moai init now works correctly without requiring deprecated command filesIssues Resolved:
moai init no longer fails with "Required Alfred command files not found"ModuleNotFoundError: No module named 'yaml'None. All changes are backward compatible.
moai init failed with "Required Alfred command files not found: 0-project.md, 1-plan.md, 2-run.md, 3-sync.md".claude/commands/moai/ to skill system, but validator.py wasn't updatedREQUIRED_ALFRED_COMMANDS to empty list with deprecation notesrc/moai_adk/core/project/validator.pyModuleNotFoundError: No module named 'yaml'YAML_AVAILABLE flag.claude/hooks/moai/lib/version_reader.py.claude/hooks/moai/lib/project.py.claude/hooks/moai/lib/unified_timeout_manager.py# Update to the latest version
claude install moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
moai init 검증 오류와 hook 스크립트 PyYAML 의존성 문제를 수정하는 패치 릴리스입니다.
주요 수정:
moai init가 더 이상 deprecated 명령 파일 요구로 실패하지 않음해결된 문제:
moai init가 "Required Alfred command files not found" 오류로 실패하지 않음ModuleNotFoundError: No module named 'yaml'로 실패하지 않음없음. 모든 변경사항은 하위 호환됩니다.
moai init 실행 중 "Required Alfred command files not found: 0-project.md, 1-plan.md, 2-run.md, 3-sync.md" 오류.claude/commands/moai/가 skill 시스템으로 마이그레이션되었으나 validator.py가 업데이트되지 않음REQUIRED_ALFRED_COMMANDS를 빈 리스트로 변경하고 deprecation note 추가src/moai_adk/core/project/validator.pyModuleNotFoundError: No module named 'yaml' 오류YAML_AVAILABLE 플래그 사용.claude/hooks/moai/lib/version_reader.py.claude/hooks/moai/lib/project.py.claude/hooks/moai/lib/unified_timeout_manager.py# 최신 버전으로 업데이트
claude install moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Minor release introducing autonomous frontend development workflow with Google Stitch MCP Build Loop pattern.
Minor release introducing autonomous frontend development workflow with Google Stitch MCP Build Loop pattern.
Key Features:
Impact:
None. All changes are backward compatible.
/stitch loop <screenshot-path>: Start autonomous build loop/stitch resume: Continue from saved baton/stitch status: Show current loop state/stitch stop: Stop running loop.stitch/batons/moai-platform-stitch updated to v2.0.0
.claude/skills/moai-platform-stitch/SKILL.md (+128 lines)src/moai_adk/templates/.claude/skills/moai-platform-stitch/SKILL.md (+128 lines)docs: Fix manager count and SPEC file structure documentation (4c370e2e)
README.md (manager count clarification).claude/skills/moai-workflow-spec/SKILL.md (SPEC structure updates)docs: Fix manager count in Korean, Chinese, Japanese README (f7f8df78)
README.ko.mdREADME.ja.mdREADME.zh.mdlogin instead of register)tests/cli/commands/test_rank.py# Update to the latest version
claude install moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
Google Stitch MCP Build Loop 패턴을 도입하는 마이너 릴리스입니다.
주요 기능:
영향:
없음. 모든 변경사항은 하위 호환됩니다.
/stitch loop <screenshot-path>: 자율형 Build Loop 시작/stitch resume: 저장된 Baton에서 계속하기/stitch status: 현재 루프 상태 표시/stitch stop: 실행 중인 루프 중지.stitch/batons/ 기반 JSON Baton 파일moai-platform-stitch v2.0.0으로 업데이트
.claude/skills/moai-platform-stitch/SKILL.md (+128줄)src/moai_adk/templates/.claude/skills/moai-platform-stitch/SKILL.md (+128줄)docs: 매니저 개수 및 SPEC 파일 구조 문서 수정 (4c370e2e)
README.md (매니저 개수 명확화).claude/skills/moai-workflow-spec/SKILL.md (SPEC 구조 업데이트)docs: 한국어, 중국어, 일본어 README 매니저 개수 수정 (f7f8df78)
README.ko.mdREADME.ja.mdREADME.zh.mdlogin, register 대신)tests/cli/commands/test_rank.py# 최신 버전으로 업데이트
claude install moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Patch release fixing CLAUDE.md corruption issue during project initialization.
Patch release fixing CLAUDE.md corruption issue during project initialization.
Key Fix:
<system-reminder> tagsImpact:
moai initsrc/moai_adk/core/template/processor.py (lines 1267-1314)# Update to the latest version
claude install moai-adk
# Update project templates
moai update
# Verify version
moai --version
프로젝트 초기화 중 CLAUDE.md 손상 문제를 수정하는 패치 릴리스입니다.
주요 수정:
<system-reminder> 태그로 @path 참조 처리영향:
src/moai_adk/core/template/processor.py (1267-1314행)# 최신 버전으로 업데이트
claude install moai-adk
# 프로젝트 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Patch release simplifying CLAUDE.md handling to always use English version.
Patch release simplifying CLAUDE.md handling to always use English version.
Key Change:
Impact:
moai init copies language-specific CLAUDE.md (ko/ja/zh) based on conversation_languagemoai init ALWAYS copies English CLAUDE.md regardless of conversation_language_copy_claude_md() to always use English templatesrc/moai_adk/core/template/processor.py (lines 1267-1294)src/moai_adk/templates/CLAUDE.ko.md (deleted)src/moai_adk/templates/CLAUDE.ja.md (deleted)src/moai_adk/templates/CLAUDE.zh.md (deleted)# Update to the latest version
claude install moai-adk
# Update project templates
moai update
# Verify version
moai --version
CLAUDE.md 처리를 항상 영어 버전만 사용하도록 단순화하는 패치 릴리스입니다.
주요 변경:
영향:
_copy_claude_md()를 단순화하여 항상 영어 템플릿 사용src/moai_adk/core/template/processor.py (1267-1294행)src/moai_adk/templates/CLAUDE.ko.md (삭제됨)src/moai_adk/templates/CLAUDE.ja.md (삭제됨)src/moai_adk/templates/CLAUDE.zh.md (삭제됨)# 최신 버전으로 업데이트
claude install moai-adk
# 프로젝트 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Deprecated /moai:plan, /moai:run, /moai:sync subcommands
Patch release fixing template variable substitution during project initialization, plus documentation and command syntax improvements.
Key Fix:
moai initImpact:
{{HOOK_SHELL_PREFIX}}, {{HOOK_SHELL_SUFFIX}}, {{MCP_SHELL}} not substituted during moai init_merge_settings_json called before variable substitution in _copy_claude methodsrc/moai_adk/core/template/processor.py (lines 958-992)src/moai_adk/templates/.mcp.json (formatting fix)fix(statusline): Use template priority for statusLine to enable shell wrapper substitution (119c5b1c)
fix(types): Add type annotation for RTL_LANGUAGES (28713c33)
test_context_manager_session_recovery.pytest_update_final.pydocs: Migrate /moai: commands to unified /moai syntax (15ea1dd8)
/moai:plan, /moai:run, /moai:sync subcommands/moai plan, /moai run, /moai sync syntaxdocs: Remove Memory MCP section from translated CLAUDE files (02eb66c1)
docs: Split CHANGELOG into separate language files (56fa9ecd)
chore: Remove localized files from project root (66214271)
# Update to the latest version
claude install moai-adk
# Update project templates
moai update
# Verify version
moai --version
프로젝트 초기화 중 템플릿 변수 치환 문제를 수정하고, 문서 및 명령어 구문을 개선하는 패치 릴리스입니다.
주요 수정:
moai init 중 템플릿 변수가 치환되지 않는 문제 수정영향:
moai init 중 {{HOOK_SHELL_PREFIX}}, {{HOOK_SHELL_SUFFIX}}, {{MCP_SHELL}} 변수가 치환되지 않음_copy_claude 메서드에서 변수 치환 전에 _merge_settings_json이 호출됨src/moai_adk/core/template/processor.py (958-992행)src/moai_adk/templates/.mcp.json (형식 수정)fix(statusline): 템플릿 우선순위를 사용하여 statusLine의 셸 래퍼 치환 활성화 (119c5b1c)
fix(types): RTL_LANGUAGES에 대한 타입 어노테이션 추가 (28713c33)
test_context_manager_session_recovery.pytest_update_final.pydocs: /moai: 명령어를 통합 /moai 구문으로 마이그레이션 (15ea1dd8)
/moai:plan, /moai:run, /moai:sync 하위 명령어 폐지/moai plan, /moai run, /moai sync 구문으로 마이그레이션docs: 번역된 CLAUDE 파일에서 Memory MCP 섹션 제거 (02eb66c1)
docs: CHANGELOG를 별도 언어 파일로 분리 (56fa9ecd)
chore: 프로젝트 루트에서 현지화 파일 제거 (66214271)
# 최신 버전으로 업데이트
claude install moai-adk
# 프로젝트 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Minor release introducing persistent memory across sessions, comprehensive SVG skill, and standards-compliant rules system migration.
Minor release introducing persistent memory across sessions, comprehensive SVG skill, and standards-compliant rules system migration.
Key Features:
.moai/rules/*.yaml to .claude/rules/*.md (Claude Code official standard)Impact:
None. All changes are backward compatible.
.mcp.json, .mcp.windows.jsonmoai-foundation-memory (420 lines).claude/rules/ for better organizationshell_validator.py utility for cross-platform compatibilitymoai-workflow-thinking skill.moai/rules/*.yaml to .claude/rules/*.md (Claude Code official standard).claude/rules/{core,development,workflow,languages}/moai-adk rank sync always showed "Submitted: 0"data field extractiondata = response.get("data", {}) before accessing fields```bash
uv tool update moai-adk
moai update
moai --version ```
세션 간 지속적인 메모리, 포괄적인 SVG 스킬, 표준 준수 rules 시스템 마이그레이션을 도입한 마이너 릴리즈.
주요 기능:
.moai/rules/*.yaml에서 .claude/rules/*.md로 마이그레이션 (Claude Code 공식 표준)영향:
없음. 모든 변경 사항은 하위 호환됩니다.
.mcp.json, .mcp.windows.jsonmoai-foundation-memory (420 lines).claude/rules/로 이동하여 구성 개선shell_validator.py 유틸리티 추가moai-workflow-thinking 스킬 추가.moai/rules/*.yaml에서 .claude/rules/*.md로 마이그레이션 (Claude Code 공식 표준).claude/rules/{core,development,workflow,languages}/moai-adk rank sync가 항상 "Submitted: 0" 표시data 필드 추출 누락data = response.get("data", {}) 추가```bash
uv tool update moai-adk
moai update
moai --version ```
Patch release improving statusline context window calculation accuracy.
Patch release improving statusline context window calculation accuracy.
Key Fix:
Impact:
used_percentage/remaining_percentage from Claude Code (most accurate)current_usage tokens (fallback)src/moai_adk/statusline/main.py```bash
uv tool update moai-adk
moai update
moai --version ```
Statusline context window 계산 정확도 개선 패치 릴리즈.
주요 수정:
영향:
```bash
uv tool update moai-adk
moai update
moai --version ```
`bash uv tool update moai-adk `
uv tool update moai-adk
See CHANGELOG.md for details.
🤖 Automated by Simple Deploy Pipeline
Patch release focused on cross-platform hook command fixes. This release fixes MoAI Rank hook failures and ensures statusLine commands are automatical
Patch release focused on cross-platform hook command fixes. This release fixes MoAI Rank hook failures and ensures statusLine commands are automatically updated during moai update.
Key Fixes:
moai updateImpact:
moai updateNone. This release is backward compatible with v1.8.10.
bash is not in PATH${SHELL:-/bin/bash} instead of hardcoded bash for Unix platformsuv run for proper module resolutionvalidate_and_fix_hook() function for automatic hook validationmoai init and moai update to validate hooks on executionsrc/moai_adk/rank/hook.py: Hook registration and validationsrc/moai_adk/cli/commands/init.py: Hook validation on initsrc/moai_adk/cli/commands/update.py: Hook validation on update_update_statusline_command() function to update.pymoai update{{HOOK_SHELL_PREFIX}}, etc.)uv run --no-sync moai-adk statusline${SHELL:-/bin/bash} -l -c 'uv run --no-sync moai-adk statusline'src/moai_adk/cli/commands/update.py# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
크로스 플랫폼 hook 명령어 수정에 집중한 패치 릴리스입니다. MoAI Rank hook 실패 문제를 수정하고 moai update 실행 시 statusLine 명령어를 자동으로 업데이트합니다.
주요 수정사항:
moai update 실행 시 statusLine 명령어 형식 자동 업데이트영향:
moai update 후 수동 조치 불필요없음. v1.8.10과 완전히 호환됩니다.
bash가 PATH에 없는 시스템에서 SessionEnd hook 실패 문제 수정bash 대신 ${SHELL:-/bin/bash} 사용uv run 추가validate_and_fix_hook() 함수 추가moai init 및 moai update 실행 시 hook 검증 수행src/moai_adk/rank/hook.py: Hook 등록 및 검증src/moai_adk/cli/commands/init.py: Init 시 hook 검증src/moai_adk/cli/commands/update.py: Update 시 hook 검증_update_statusline_command() 함수 추가moai update 실행 시 statusLine 명령어 형식을 자동으로 수정{{HOOK_SHELL_PREFIX}} 등)uv run --no-sync moai-adk statusline${SHELL:-/bin/bash} -l -c 'uv run --no-sync moai-adk statusline'src/moai_adk/cli/commands/update.py# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Minor release focused on performance optimization and cross-platform compatibility improvements. This release adds Claude Code environment variables f
Minor release focused on performance optimization and cross-platform compatibility improvements. This release adds Claude Code environment variables for cost reduction and fixes statusLine command PATH loading.
Key Features:
Impact:
None. This release is backward compatible with v1.8.9.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1: Block non-essential traffic (autoupdater, bug reports, telemetry)DISABLE_NON_ESSENTIAL_MODEL_CALLS=1: Prevent flavor text model calls, reduce token costsENABLE_TOOL_SEARCH: Changed from "1" to "auto:5" for better efficiency (trigger at 5% context usage)src/moai_adk/templates/.claude/settings.json, .claude/settings.json{{HOOK_SHELL_PREFIX}}...{{HOOK_SHELL_SUFFIX}}${SHELL:-/bin/bash} -l -c '...'uv is found via login shell on macOS/Linuxsrc/moai_adk/templates/.claude/settings.json, .claude/settings.json# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
성능 최적화와 크로스 플랫폼 호환성 개선에 중점을 둔 마이너 릴리스입니다. Claude Code 환경변수를 추가하여 비용 절감 및 statusLine 명령 PATH 로딩을 수정했습니다.
주요 기능:
영향:
없음. 이 릴리스는 v1.8.9와 하위 호환됩니다.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1: 불필요한 트래픽 차단 (자동 업데이트, 버그 리포트, 텔레메트리)DISABLE_NON_ESSENTIAL_MODEL_CALLS=1: Flavor text 모델 호출 방지, 토큰 비용 절감ENABLE_TOOL_SEARCH: "1"에서 "auto:5"로 변경하여 효율성 개선 (컨텍스트 5% 사용 시 검색 시작)src/moai_adk/templates/.claude/settings.json, .claude/settings.json{{HOOK_SHELL_PREFIX}}...{{HOOK_SHELL_SUFFIX}} 사용${SHELL:-/bin/bash} -l -c '...' 사용uv를 찾도록 보장src/moai_adk/templates/.claude/settings.json, .claude/settings.json# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Critical bug fix release addressing Windows platform compatibility issues discovered in v1.8.8. This patch fixes template variable validation and MCP
Critical bug fix release addressing Windows platform compatibility issues discovered in v1.8.8. This patch fixes template variable validation and MCP configuration for Windows users.
Key Fixes:
HOOK_SHELL_PREFIX and HOOK_SHELL_SUFFIX on Windows.mcp.json template selection (Windows vs Unix)Impact:
moai update without template substitution errorscmd /c args formatNone. This release is backward compatible with v1.8.8.
_is_valid_template_variable() to allow empty strings for HOOK_SHELL_PREFIX and HOOK_SHELL_SUFFIXsrc/moai_adk/core/template/processor.py:550-554.mcp.windows.json with correct cmd /c args format.mcp.json with correct shell -l -c args formatsrc/moai_adk/core/template/processor.py:1507-1563# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
v1.8.8에서 발견된 Windows 플랫폼 호환성 문제를 해결하는 중요 버그 수정 릴리스입니다. Windows 사용자를 위한 템플릿 변수 validation 및 MCP 설정을 수정했습니다.
주요 수정사항:
HOOK_SHELL_PREFIX와 HOOK_SHELL_SUFFIX 빈 문자열 validation 수정.mcp.json 템플릿 선택 (Windows vs Unix)영향:
moai update 실행 가능cmd /c args 형식으로 정상 시작없음. 이 릴리스는 v1.8.8과 하위 호환됩니다.
_is_valid_template_variable()을 수정하여 HOOK_SHELL_PREFIX와 HOOK_SHELL_SUFFIX에 대해 빈 문자열 허용src/moai_adk/core/template/processor.py:550-554cmd /c args 형식의 .mcp.windows.json 사용shell -l -c args 형식의 .mcp.json 사용src/moai_adk/core/template/processor.py:1507-1563# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
This patch release completes the cross-platform hook system by extending template variable substitution to .mcp.json files and unifying agent hook pat
This patch release completes the cross-platform hook system by extending template variable substitution to .mcp.json files and unifying agent hook patterns. It also introduces the MoAI Rank session tracking system for optional token usage analytics.
Key Changes:
moai update{{HOOK_SHELL_PREFIX}}/{{HOOK_SHELL_SUFFIX}}Impact:
.mcp.json now correctly applies {{MCP_SHELL}} substitutionNone. This release is backward compatible with v1.8.7.
_copy_mcp_json() in processor.py to apply _substitute_variables(){{MCP_SHELL}} was not being replaced during moai updatesrc/moai_adk/core/template/processor.pyfix(template): Use HOOK_SHELL_PREFIX/SUFFIX template variables in agent hooks (991f68eb)
bash -l -c with {{HOOK_SHELL_PREFIX}} template variable{{PROJECT_DIR}}{{HOOK_SHELL_SUFFIX}} from documentation examplessrc/moai_adk/templates/.claude/agents/moai/*.md (9 agents)fix(local): Apply correct hook shell wrapper pattern to local agents (62c43e7e)
${SHELL:-/bin/bash} -l -c pattern.claude/agents/moai/*.mdsession_end__rank_submit.py hook for token usage tracking~/.moai/rank/config.yaml exclude_projects setting.claude/hooks/moai/session_end__rank_submit.pydocs(release): Improve version file checklist in 99-release command (cb9e0fc2)
system.yaml to checklist.claude/commands/moai/99-release.mdstyle: Auto-fix lint and format issues (5dd388de)
Before (v1.8.7 - Issue):
# _copy_mcp_json() used direct file copy
shutil.copy2(src, dst) # No template substitution!
After (v1.8.8 - Fixed):
# _copy_mcp_json() applies template variable substitution
template_content = src.read_text()
substituted_content, warnings = self._substitute_variables(template_content)
dst.write_text(substituted_content)
v1.8.7 Pattern (Inconsistent):
hooks:
PostToolUse:
- matcher: "Write|Edit"
hooks:
- command: "bash -l -c 'uv run \"{{PROJECT_DIR}}\"/.claude/hooks/...'"
v1.8.8 Pattern (Unified):
hooks:
PostToolUse:
- matcher: "Write|Edit"
hooks:
- command: "{{HOOK_SHELL_PREFIX}}uv run \"{{PROJECT_DIR}}\".claude/hooks/...{{HOOK_SHELL_SUFFIX}}"
src/moai_adk/core/template/processor.py: Template substitution logicsrc/moai_adk/templates/.claude/agents/moai/*.md: 9 agent templates.claude/agents/moai/*.md: 11 local agents.claude/hooks/moai/session_end__rank_submit.py: New hook.claude/commands/moai/99-release.md: Release workflow doc# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 패치 릴리스는 템플릿 변수 치환을 .mcp.json 파일로 확장하고 에이전트 후크 패턴을 통합하여 크로스 플랫폼 후크 시스템을 완성합니다. 또한 선택적 토큰 사용량 분석을 위한 MoAI Rank 세션 추적 시스템을 도입합니다.
주요 변경사항:
moai update 시 MCP 템플릿 변수 치환{{HOOK_SHELL_PREFIX}}/{{HOOK_SHELL_SUFFIX}}로 통합된 에이전트 후크 패턴영향:
.mcp.json이 이제 {{MCP_SHELL}} 치환을 올바르게 적용없음. 이 릴리스는 v1.8.7과 하위 호환됩니다.
processor.py의 _copy_mcp_json()을 수정하여 _substitute_variables() 적용moai update 시 {{MCP_SHELL}}이 대체되지 않던 문제 해결src/moai_adk/core/template/processor.pyfix(template): 에이전트 후크에서 HOOK_SHELL_PREFIX/SUFFIX 템플릿 변수 사용 (991f68eb)
bash -l -c를 {{HOOK_SHELL_PREFIX}} 템플릿 변수로 교체{{PROJECT_DIR}} 뒤의 불필요한 슬래시 제거{{HOOK_SHELL_SUFFIX}} 제거src/moai_adk/templates/.claude/agents/moai/*.md (9개 에이전트)fix(local): 로컬 에이전트에 올바른 후크 셸 래퍼 패턴 적용 (62c43e7e)
${SHELL:-/bin/bash} -l -c 패턴으로 11개 로컬 에이전트 파일 업데이트.claude/agents/moai/*.mdsession_end__rank_submit.py 후크~/.moai/rank/config.yaml exclude_projects 설정으로 옵트아웃 가능.claude/hooks/moai/session_end__rank_submit.pydocs(release): 99-release 명령의 버전 파일 체크리스트 개선 (cb9e0fc2)
system.yaml 추가.claude/commands/moai/99-release.mdstyle: 린트 및 포맷 문제 자동 수정 (5dd388de)
이전 (v1.8.7 - 문제):
# _copy_mcp_json()이 직접 파일 복사 사용
shutil.copy2(src, dst) # 템플릿 치환 없음!
이후 (v1.8.8 - 수정됨):
# _copy_mcp_json()이 템플릿 변수 치환 적용
template_content = src.read_text()
substituted_content, warnings = self._substitute_variables(template_content)
dst.write_text(substituted_content)
v1.8.7 패턴 (일관성 없음):
hooks:
PostToolUse:
- matcher: "Write|Edit"
hooks:
- command: "bash -l -c 'uv run \"{{PROJECT_DIR}}\"/.claude/hooks/...'"
v1.8.8 패턴 (통합됨):
hooks:
PostToolUse:
- matcher: "Write|Edit"
hooks:
- command: "{{HOOK_SHELL_PREFIX}}uv run \"{{PROJECT_DIR}}\".claude/hooks/...{{HOOK_SHELL_SUFFIX}}"
src/moai_adk/core/template/processor.py: 템플릿 치환 로직src/moai_adk/templates/.claude/agents/moai/*.md: 9개 에이전트 템플릿.claude/agents/moai/*.md: 11개 로컬 에이전트.claude/hooks/moai/session_end__rank_submit.py: 새 후크.claude/commands/moai/99-release.md: 릴리스 워크플로우 문서# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
The release also implements automatic cleanup of deprecated settings during updates.
This patch release extends the shell wrapper system to MCP (Model Context Protocol) servers, fixing connection failures after moai update on systems where npx is defined as a bash function. The release also implements automatic cleanup of deprecated settings during updates.
Key Changes:
{{MCP_SHELL}} template variableCLAUDE_CODE_MAX_OUTPUT_TOKENS setting${SHELL:-/bin/bash} (Unix) / cmd (Windows)Impact:
None. This release is backward compatible with v1.8.6.
feat: Implement dynamic shell detection for MCP servers (ee7e1adb)
{{MCP_SHELL}}${SHELL:-/bin/bash} (runtime shell detection)cmd (system PATH auto-loaded)src/moai_adk/cli/commands/update.py, src/moai_adk/templates/.mcp.jsonfeat(mcp): Apply MCP_SHELL template variable to Windows config (db6a10cc)
src/moai_adk/templates/.mcp.windows.jsonmoai update--templates-only and normal update pathssrc/moai_adk/cli/commands/update.pymoai update/bin/bash -l -c "exec npx ..."src/moai_adk/templates/.mcp.jsondocs(mcp): Improve Windows MCP configuration comments and args format (3ea10c0f)
src/moai_adk/templates/.mcp.windows.jsonsync: Apply dynamic shell detection to local .mcp.json (c1339e42)
.mcp.json# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 패치 릴리스는 셸 래퍼 시스템을 MCP(Model Context Protocol) 서버로 확장하여, npx가 bash 함수로 정의된 시스템에서 moai update 후 발생하는 연결 실패 문제를 해결합니다. 또한 업데이트 시 deprecated 설정의 자동 정리 기능을 구현했습니다.
주요 변경사항:
{{MCP_SHELL}} 템플릿 변수CLAUDE_CODE_MAX_OUTPUT_TOKENS 설정 자동 제거${SHELL:-/bin/bash} (Unix) / cmd (Windows)영향:
없음. 이 릴리스는 v1.8.6과 하위 호환됩니다.
feat: MCP 서버용 동적 셸 감지 구현 (ee7e1adb)
{{MCP_SHELL}}${SHELL:-/bin/bash} (런타임 셸 감지)cmd (시스템 PATH 자동 로드)src/moai_adk/cli/commands/update.py, src/moai_adk/templates/.mcp.jsonfeat(mcp): Windows 설정에 MCP_SHELL 템플릿 변수 적용 (db6a10cc)
src/moai_adk/templates/.mcp.windows.jsonmoai update 시 자동 정리--templates-only 및 일반 업데이트 경로 모두 적용src/moai_adk/cli/commands/update.pymoai update 후 "Failed to reconnect" 오류 해결/bin/bash -l -c "exec npx ..."src/moai_adk/templates/.mcp.jsondocs(mcp): Windows MCP 설정 주석 및 args 형식 개선 (3ea10c0f)
src/moai_adk/templates/.mcp.windows.jsonsync: 로컬 .mcp.json에 동적 셸 감지 적용 (c1339e42)
.mcp.json# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
This minor release implements a universal shell wrapper system that respects user's default shell on all platforms, resolving shell-specific PATH load
This minor release implements a universal shell wrapper system that respects user's default shell on all platforms, resolving shell-specific PATH loading issues. The system automatically uses the user's preferred shell (zsh, bash, etc.) instead of forcing bash, ensuring environment variables are loaded correctly on macOS, Linux, Windows Git Bash, and WSL.
Key Changes:
${SHELL:-/bin/bash} -l -c for all Unix platforms{{HOOK_SHELL_PREFIX}} and {{HOOK_SHELL_SUFFIX}}Impact:
None. This release is backward compatible with v1.8.4.
fix(templates): Fix double slash in hook paths after PROJECT_DIR substitution (69f12f88)
{{PROJECT_DIR}}/.claude/ → {{PROJECT_DIR}}.claude/{{PROJECT_DIR}} already includes trailing slash by design (v1.8.0)src/moai_adk/templates/.claude/settings.jsonfix(templates): Fix double slash in agent hook paths after PROJECT_DIR substitution (e0e3c24e)
src/moai_adk/templates/.claude/agents/moai/*.md{{HOOK_SHELL_PREFIX}}, {{HOOK_SHELL_SUFFIX}}${SHELL:-/bin/bash} -l -c (respects user's default shell)~/.zshenv) or bash config (~/.bash_profile)src/moai_adk/cli/commands/update.pyCLAUDE.local.md: Cross-Platform Development GuidelinesCLAUDE.local.md (Section 20, 240+ lines)sync: Update local .claude/ from templates with cross-platform shell wrapper (3bf75656)
expert-stitch.md (not in v1.8.6 template)${SHELL:-/bin/bash} -l -c for PATH loadingchore: Bump version to 1.8.6 (97e76ff2)
pyproject.toml, src/moai_adk/version.py, .moai/config/config.yaml, .moai/config/sections/system.yamlv1.8.4 Pattern (Issue: Forced bash on zsh users):
{
"command": "bash -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_start.py\"'"
}
v1.8.6 Pattern (Solution: Respects user's shell):
{
"command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_start.py\"'"
}
| Variable | Usage | Example |
|---|---|---|
{{HOOK_SHELL_PREFIX}} |
Shell wrapper opening | ${SHELL:-/bin/bash} -l -c ' (Unix) or "" (Windows) |
{{HOOK_SHELL_SUFFIX}} |
Shell wrapper closing | ' (Unix) or "" (Windows) |
{{PROJECT_DIR}} |
Project path with trailing separator | $CLAUDE_PROJECT_DIR/ (forward slash, cross-platform) |
| Platform | Shell Wrapper | Loaded Config Files | Status |
|---|---|---|---|
| macOS (zsh) | zsh -l -c |
~/.zshenv, ~/.zprofile |
✅ Fixed |
| macOS (bash) | bash -l -c |
~/.bash_profile, ~/.bashrc |
✅ Works |
| Linux (bash) | bash -l -c |
~/.bash_profile, ~/.bashrc |
✅ Works |
| WSL (bash/zsh) | Respects $SHELL |
User's shell config | ✅ Fixed |
| Windows Git Bash | bash -l -c |
.bash_profile |
✅ Works |
| Windows PowerShell | Direct execution | System PATH | ✅ Works |
src/moai_adk/cli/commands/update.py: Shell wrapper generation logic (lines 1845-1862)src/moai_adk/templates/.claude/settings.json: All 6 hooks updatedsrc/moai_adk/templates/.claude/agents/moai/*.md: 12 agents updatedCLAUDE.local.md: Cross-platform development guidelines addedpyproject.toml, src/moai_adk/version.py: Version updated to 1.8.6.moai/config/config.yaml, .moai/config/sections/system.yaml: Version synced# Install MoAI-ADK
uv tool install moai-adk
# Initialize project (automatically uses v1.8.6 templates)
moai init
# Update MoAI-ADK
uv tool install moai-adk
# Update project templates - hooks automatically use shell wrapper
moai update
# Verify version
moai --version # Should show 1.8.6
Note: The moai update command automatically updates all hook commands to use the new shell wrapper pattern. No manual intervention required.
# Update to the latest version
uv tool install moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 마이너 릴리스는 모든 플랫폼에서 사용자의 기본 셸을 존중하는 범용 셸 래퍼 시스템을 구현하여 셸별 PATH 로딩 문제를 해결합니다. 시스템은 bash를 강제하는 대신 사용자의 선호 셸(zsh, bash 등)을 자동으로 사용하여 macOS, Linux, Windows Git Bash, WSL에서 환경 변수가 올바르게 로드되도록 보장합니다.
주요 변경사항:
${SHELL:-/bin/bash} -l -c{{HOOK_SHELL_PREFIX}}와 {{HOOK_SHELL_SUFFIX}}영향:
없음. 이 릴리스는 v1.8.4와 하위 호환됩니다.
fix(templates): PROJECT_DIR 치환 후 hook 경로의 이중 슬래시 수정 (69f12f88)
{{PROJECT_DIR}}/.claude/ → {{PROJECT_DIR}}.claude/{{PROJECT_DIR}}는 설계상 이미 후행 슬래시 포함 (v1.8.0)src/moai_adk/templates/.claude/settings.jsonfix(templates): PROJECT_DIR 치환 후 agent hook 경로의 이중 슬래시 수정 (e0e3c24e)
src/moai_adk/templates/.claude/agents/moai/*.md{{HOOK_SHELL_PREFIX}}, {{HOOK_SHELL_SUFFIX}}${SHELL:-/bin/bash} -l -c (사용자의 기본 셸 존중)~/.zshenv) 또는 bash 설정(~/.bash_profile)을 자동으로 로드src/moai_adk/cli/commands/update.pyCLAUDE.local.md에 새 섹션: 크로스 플랫폼 개발 가이드라인CLAUDE.local.md (Section 20, 240+ 줄)sync: 크로스 플랫폼 셸 래퍼로 로컬 .claude/ 템플릿에서 업데이트 (3bf75656)
expert-stitch.md 제거 (v1.8.6 템플릿에 없음)${SHELL:-/bin/bash} -l -c 사용chore: 버전을 1.8.6으로 업데이트 (97e76ff2)
pyproject.toml, src/moai_adk/version.py, .moai/config/config.yaml, .moai/config/sections/system.yamlv1.8.4 패턴 (문제: zsh 사용자에게 bash 강제):
{
"command": "bash -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_start.py\"'"
}
v1.8.6 패턴 (해결: 사용자의 셸 존중):
{
"command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_start.py\"'"
}
| 변수 | 사용 | 예제 |
|---|---|---|
{{HOOK_SHELL_PREFIX}} |
셸 래퍼 시작 | ${SHELL:-/bin/bash} -l -c ' (Unix) 또는 "" (Windows) |
{{HOOK_SHELL_SUFFIX}} |
셸 래퍼 종료 | ' (Unix) 또는 "" (Windows) |
{{PROJECT_DIR}} |
후행 구분자가 있는 프로젝트 경로 | $CLAUDE_PROJECT_DIR/ (슬래시, 크로스 플랫폼) |
| 플랫폼 | 셸 래퍼 | 로드되는 설정 파일 | 상태 |
|---|---|---|---|
| macOS (zsh) | zsh -l -c |
~/.zshenv, ~/.zprofile |
✅ 수정됨 |
| macOS (bash) | bash -l -c |
~/.bash_profile, ~/.bashrc |
✅ 작동 |
| Linux (bash) | bash -l -c |
~/.bash_profile, ~/.bashrc |
✅ 작동 |
| WSL (bash/zsh) | $SHELL 존중 |
사용자의 셸 설정 | ✅ 수정됨 |
| Windows Git Bash | bash -l -c |
.bash_profile |
✅ 작동 |
| Windows PowerShell | 직접 실행 | 시스템 PATH | ✅ 작동 |
src/moai_adk/cli/commands/update.py: 셸 래퍼 생성 로직 (1845-1862줄)src/moai_adk/templates/.claude/settings.json: 모든 6개 hook 업데이트src/moai_adk/templates/.claude/agents/moai/*.md: 12개 agent 업데이트CLAUDE.local.md: 크로스 플랫폼 개발 가이드라인 추가pyproject.toml, src/moai_adk/version.py: 버전 1.8.6으로 업데이트.moai/config/config.yaml, .moai/config/sections/system.yaml: 버전 동기화# MoAI-ADK 설치
uv tool install moai-adk
# 프로젝트 초기화 (자동으로 v1.8.6 템플릿 사용)
moai init
# MoAI-ADK 업데이트
uv tool install moai-adk
# 프로젝트 템플릿 업데이트 - hook이 자동으로 셸 래퍼 사용
moai update
# 버전 확인
moai --version # 1.8.6이 표시되어야 함
참고: moai update 명령이 모든 hook 명령을 새로운 셸 래퍼 패턴으로 자동 업데이트합니다. 수동 개입이 필요하지 않습니다.
# 최신 버전으로 업데이트
uv tool install moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
This patch release completely resolves Issue #296 (moai update PATH loading issues) by implementing login shell execution for all hooks, ensuring PATH
This patch release completely resolves Issue #296 (moai update PATH loading issues) by implementing login shell execution for all hooks, ensuring PATH environment variables are correctly loaded on WSL, macOS, Linux, and Windows Git Bash.
Key Changes:
bash -l -c wrapper for PATH loadingmoai updateReference: Issue #296
fix(hooks): Use login shell for hooks to ensure PATH is loaded
bash -l -c wrapper pattern~/.bashrc, ~/.zshrc, and .bash_profile are loadedcommand not found: uv errors in non-interactive shellsfix(hooks): Update agent hooks to use login shell for PATH loading
bash -l -c wrapperfix(rank): Update moai rank SessionEnd hook to use bash login shell
bash -l -c wrappermoai update now automatically converts old hook commands to bash -l -c format```bash
uv tool install moai-adk
moai update
moai --version ```
이 패치 릴리스는 모든 hook에 로그인 셸 실행을 구현하여 Issue #296 (moai update PATH 로딩 문제)을 완전히 해결하며, WSL, macOS, Linux, Windows Git Bash에서 PATH 환경 변수가 올바르게 로드되도록 보장합니다.
주요 변경사항:
bash -l -c 래퍼 사용moai update 실행 시 MoAI Rank hook 자동 업데이트참조: Issue #296
fix(hooks): PATH 로딩을 위해 로그인 셸 사용
bash -l -c 래퍼 패턴 사용~/.bashrc, ~/.zshrc, .bash_profile 로드 보장command not found: uv 에러 해결fix(hooks): PATH 로딩을 위해 에이전트 hook을 로그인 셸로 업데이트
bash -l -c 래퍼로 업데이트fix(rank): bash 로그인 셸을 사용하도록 moai rank SessionEnd hook 업데이트
bash -l -c 래퍼로 hook 등록moai update가 기존 hook 명령을 bash -l -c 형식으로 자동 변환```bash
uv tool install moai-adk
moai update
moai --version ```
This patch release restores complete WSL (Windows Subsystem for Linux) support after it was incorrectly blocked in v1.8.2. MoAI-ADK now provides seaml
This patch release restores complete WSL (Windows Subsystem for Linux) support after it was incorrectly blocked in v1.8.2. MoAI-ADK now provides seamless path conversion for WSL environments, resolving Issue #295.
Key Changes:
Reference: Issue #295, Claude Code Issue #19653
Complete WSL support for WSL 1 and WSL 2
Path Conversion Features:
convert_windows_to_wsl(): C:\... → /mnt/c/...convert_wsl_to_windows(): Reverse conversionnormalize_path_for_wsl(): Smart normalizationTesting: 112 comprehensive WSL tests (100% pass rate)
CLAUDE_PROJECT_DIR with Windows paths works correctly in WSL/mnt/c/ projects# Update to the latest version
uv tool install moai-adk
# Verify version
moai --version
이 패치 릴리스는 v1.8.2에서 잘못 차단된 WSL (Windows Subsystem for Linux) 지원을 복원합니다. MoAI-ADK는 이제 WSL 환경을 위한 원활한 경로 변환을 제공하여 Issue #295를 해결합니다.
주요 변경사항:
참조: Issue #295, Claude Code Issue #19653
WSL 1 및 WSL 2 완벽 지원
경로 변환 기능:
convert_windows_to_wsl(): C:\... → /mnt/c/... 변환convert_wsl_to_windows(): 역변환normalize_path_for_wsl(): 환경 기반 스마트 정규화테스트: 112개의 포괄적 WSL 테스트 (100% 통과율)
CLAUDE_PROJECT_DIR가 올바르게 작동/mnt/c/ 프로젝트의 경로 호환성 문제 해결# 최신 버전으로 업데이트
uv tool install moai-adk
# 버전 확인
moai --version
This patch release improves cross-platform compatibility for Windows, macOS, and Linux environments, fixes settings.json environment variable merge pr
This patch release improves cross-platform compatibility for Windows, macOS, and Linux environments, fixes settings.json environment variable merge priority, and enhances Windows environment validation.
Key Changes:
feat: Fix env merge priority in settings.json smart merge (d02f8d88)
fix: Ensure template variables are always substituted in settings.json (b3cc2525)
feat: Improve cross-platform compatibility (Windows/macOS/Linux) (0dc44d41)
feat: Add shell environment validation for Windows (a1613654)
docs(platform): Improve cross-platform documentation and error messages (736440d7)
docs: Clarify WSL is also not supported on Windows (2b709740)
docs: Add Windows PowerShell requirement notice to all README files (de2132b0)
```bash
uv tool update moai-adk
moai update
moai --version ```
이 패치 릴리스는 Windows, macOS, Linux 환경의 크로스 플랫폼 호환성을 개선하고, settings.json 환경 변수 병합 우선순위를 수정하며, Windows 환경 검증을 강화합니다.
주요 변경사항:
feat: settings.json 스마트 병합에서 환경 변수 병합 우선순위 수정 (d02f8d88)
fix: settings.json에서 템플릿 변수가 항상 치환되도록 보장 (b3cc2525)
feat: 크로스 플랫폼 호환성 개선 (Windows/macOS/Linux) (0dc44d41)
feat: Windows용 쉘 환경 검증 추가 (a1613654)
docs(platform): 크로스 플랫폼 문서 및 오류 메시지 개선 (736440d7)
docs: Windows에서 WSL도 미지원임을 명확화 (2b709740)
docs: 모든 README 파일에 Windows PowerShell 요구사항 공지 추가 (de2132b0)
```bash
uv tool update moai-adk
moai update
moai --version ```
Nothing published for this version
Path Variables: {{PROJECT_DIR_UNIX}} and {{PROJECT_DIR_WIN}} are deprecated, use {{PROJECT_DIR}} instead
This major release introduces Ralph-style LSP integration for autonomous workflow execution, Google Stitch MCP integration for AI-powered UI/UX design generation, comprehensive language pattern support for 12 programming languages, and cross-platform path variable consolidation.
Key Features:
Reference: SPEC-LSP-001, SPEC-STITCH-001
{{PROJECT_DIR_UNIX}} and {{PROJECT_DIR_WIN}} are deprecated, use {{PROJECT_DIR}} instead.moai/config/sections/workflow.yamlquality.yaml: lsp_quality_gatesexpert-stitch for AI-powered UI/UX design generationmcp__stitch__create_project, mcp__stitch__generate_screen_from_text, mcp__stitch__fetch_screen_codefeat(lsp): Add LSP-based completion marker system
src/moai_adk/utils/completion_marker.pyLSPState, CompletionMarker, LoopPrevention classesmcp__ide__getDiagnosticsfeat(config): Add workflow execution mode configuration
.moai/config/sections/workflow.yaml```bash
uv tool update moai-adk
moai update
moai --version ```
이 메이저 릴리스는 자율 워크플로우 실행을 위한 Ralph-style LSP 통합, AI 기반 UI/UX 디자인 생성을 위한 Google Stitch MCP 통합, 12개 프로그래밍 언어에 대한 포괄적인 언어 패턴 지원, 크로스 플랫폼 경로 변수 통합을 도입합니다.
주요 기능:
{{PROJECT_DIR_UNIX}}와 {{PROJECT_DIR_WIN}}은 더 이상 사용되지 않으며, {{PROJECT_DIR}}를 사용하세요```bash
uv tool update moai-adk
moai update
moai --version ```
This minor release introduces UltraThink mode (--ultrathink), an enhanced analysis feature that automatically applies Sequential Thinking MCP for deep
This minor release introduces UltraThink mode (--ultrathink), an enhanced analysis feature that automatically applies Sequential Thinking MCP for deep request analysis and optimal execution planning. Additionally, this release includes important agent tool permission updates and parallel execution safeguards for improved reliability.
--ultrathink keyword guidance to complex commands
/moai:alfred, /moai:0-project, /moai:1-plan, /moai:2-run, /moai:3-sync, /moai:99-releasemoai --version CLI command_is_duplicate_error() helper function with robust pattern matching# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 마이너 릴리스는 UltraThink 모드(--ultrathink)를 도입하여, Sequential Thinking MCP를 자동으로 적용하는 심층 분석 기능을 추가합니다. 또한 에이전트 도구 권한 업데이트 및 병렬 실행 안전장치를 포함하여 신뢰성을 개선했습니다.
--ultrathink 키워드 가이드 추가
/moai:alfred, /moai:0-project, /moai:1-plan, /moai:2-run, /moai:3-sync, /moai:99-releasemoai --version CLI 명령 호출로 교체_is_duplicate_error() 헬퍼 함수 추가# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
`bash uv tool update moai-adk `
uv tool update moai-adk
See CHANGELOG.md for details.
🤖 Automated by Simple Deploy Pipeline
This patch release updates the GLM API endpoint to the official BigModel API domain. The base URL has been changed from https://api.z.ai/api/anthropic
This patch release updates the GLM API endpoint to the official BigModel API domain. The base URL has been changed from https://api.z.ai/api/anthropic to https://open.bigmodel.cn/api/anthropic for improved service reliability and performance.
https://api.z.ai/api/anthropic → https://open.bigmodel.cn/api/anthropic# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 패치 릴리스는 GLM API 엔드포인트를 공식 BigModel 도메인으로 업데이트합니다. 개선된 서비스 안정성과 성능을 위해 베이스 URL이 https://api.z.ai/api/anthropic에서 https://open.bigmodel.cn/api/anthropic으로 변경되었습니다.
https://api.z.ai/api/anthropic → https://open.bigmodel.cn/api/anthropic# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
This patch release standardizes GLM model names to use lowercase naming convention for consistency with the API specification. The model names GLM-4.7
This patch release standardizes GLM model names to use lowercase naming convention for consistency with the API specification. The model names GLM-4.7-FlashX, GLM-4.7 have been updated to glm-4.7-flashx, glm-4.7 respectively.
GLM-4.7-FlashX → glm-4.7-flashxGLM-4.7 → glm-4.7# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 패치 릴리스는 API 사양과의 일관성을 위해 GLM 모델명을 소문자 명명 규칙으로 표준화합니다. GLM-4.7-FlashX, GLM-4.7 모델명이 각각 glm-4.7-flashx, glm-4.7로 업데이트되었습니다.
GLM-4.7-FlashX → glm-4.7-flashx 변경GLM-4.7 → glm-4.7 변경# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
This patch release simplifies the statusline command configuration by using the moai statusline subcommand instead of the complex PYTHONPATH-based inv
This patch release simplifies the statusline command configuration by using the moai statusline subcommand instead of the complex PYTHONPATH-based invocation. This makes the configuration more portable and easier to maintain across projects.
PYTHONPATH="$CLAUDE_PROJECT_DIR/src" python3 -m moai_adk.statusline.mainmoai statusline$CLAUDE_PROJECT_DIR dependencyuv tool install moai-adk# Update to the latest version
uv tool update moai-adk
# Update project templates in your folder
moai update
# Verify version
moai --version
이 패치 릴리스는 복잡한 PYTHONPATH 기반 호출 대신 moai statusline 서브명령어를 사용하여 statusline 명령 설정을 단순화합니다. 이를 통해 설정이 더욱 이식성 있고 프로젝트 간 유지보수가 쉬워집니다.
PYTHONPATH="$CLAUDE_PROJECT_DIR/src" python3 -m moai_adk.statusline.mainmoai statusline$CLAUDE_PROJECT_DIR 의존성 제거uv tool install moai-adk만 필요# 최신 버전으로 업데이트
uv tool update moai-adk
# 프로젝트 폴더 템플릿 업데이트
moai update
# 버전 확인
moai --version
🤖 MoAI-ADK Unified Release Pipeline
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.