@mandujs/cli 0.19.0 → 0.19.1

package/README.ko.md

@@ -23,22 +23,30 @@ bun add -D @mandujs/cli
 ## 빠른 시작
 
 ```bash
-# 새 프로젝트 생성
-bunx @mandujs/cli init my-app
-cd my-app
+# 대화형 모드 (권장)
+bunx @mandujs/cli init
+
+# 비대화형 모드
+bunx @mandujs/cli init my-app --yes
 
 # 개발 서버 시작
+cd my-app
 bun run dev
 ```
 
+대화형 모드에서는 프로젝트 이름, 템플릿, 의존성 설치 여부를 묻습니다.
+`--yes` / `-y` 플래그로 프롬프트를 건너뛸 수 있고, `--no-install`로 자동 설치를 비활성화합니다.
+
 ## 명령어
 
-### `mandu init <project-name>`
+### `mandu init [project-name]`
 
-새 Mandu 프로젝트를 생성합니다.
+새 Mandu 프로젝트를 생성합니다. 이름 생략 시 대화형 모드로 진입합니다.
 
 ```bash
-bunx @mandujs/cli init my-app
+bunx @mandujs/cli init           # 대화형
+bunx @mandujs/cli init my-app    # 비대화형 (기본 옵션)
+bunx @mandujs/cli init my-app --yes --no-install  # 설치 건너뛰기
 ```
 
 생성되는 구조:
@@ -220,6 +228,18 @@ bun test           # 테스트 실행
 bun test --watch   # 감시 모드
 ```
 
+## AI 에이전트 통합
+
+`mandu init` 시 MCP(Model Context Protocol) 설정이 자동 생성됩니다:
+
+| 에이전트 | 설정 파일 | 자동 설정 |
+|----------|-----------|-----------|
+| Claude Code | `.mcp.json` | Yes |
+| Claude Desktop | `.claude.json` | Yes |
+| Gemini CLI | `.gemini/settings.json` | Yes |
+
+`@mandujs/mcp` 서버가 `mandu_negotiate`, `mandu_generate_scaffold`, `mandu_guard` 등의 도구를 제공하여 AI 에이전트가 아키텍처를 자동으로 스캐폴딩, 검증, 유지합니다.
+
 ## 요구 사항
 
 - Bun >= 1.0.0
@@ -228,6 +248,7 @@ bun test --watch   # 감시 모드
 ## 관련 패키지
 
 - [@mandujs/core](https://www.npmjs.com/package/@mandujs/core) - 핵심 런타임
+- [@mandujs/mcp](https://www.npmjs.com/package/@mandujs/mcp) - MCP 서버
 
 ## 라이선스
 

package/README.md

@@ -30,11 +30,15 @@ bunx @mandujs/cli init my-app
 ### 1. Create a New Project
 
 ```bash
-bunx @mandujs/cli init my-app
-cd my-app
-bun install
+# Interactive mode (recommended)
+bunx @mandujs/cli init
+
+# Non-interactive mode
+bunx @mandujs/cli init my-app --yes
 ```
 
+The interactive mode asks for project name, template selection, and whether to install dependencies. Use `--yes` / `-y` to skip prompts. Use `--no-install` to skip automatic `bun install`.
+
 ### 2. Start Development Server
 
 ```bash
@@ -101,7 +105,7 @@ That's it!
 
 | Command | Description |
 |---------|-------------|
-| `mandu init [name]` | Create new project |
+| `mandu init [name]` | Create new project (interactive / `--yes` for non-interactive) |
 | `mandu dev` | Start dev server (FS Routes + HMR) |
 | `mandu build` | Build for production |
 
@@ -162,9 +166,8 @@ That's it!
 ### Modern Workflow (Recommended)
 
 ```bash
-# 1. Create project
-bunx @mandujs/cli init my-app
-cd my-app && bun install
+# 1. Create project (interactive — auto installs dependencies)
+bunx @mandujs/cli init
 
 # 2. Create pages
 # app/page.tsx        → /
@@ -340,6 +343,18 @@ bunx mandu build --minify --sourcemap
 
 ---
 
+## AI Agent Integration
+
+Mandu automatically configures MCP (Model Context Protocol) for AI coding agents during `init`:
+
+| Agent | Config File | Auto-configured |
+|-------|-------------|-----------------|
+| Claude Code | `.mcp.json` | Yes |
+| Claude Desktop | `.claude.json` | Yes |
+| Gemini CLI | `.gemini/settings.json` | Yes |
+
+The `@mandujs/mcp` server provides tools like `mandu_negotiate`, `mandu_generate_scaffold`, `mandu_guard`, and more — enabling AI agents to scaffold, validate, and maintain architecture automatically.
+
 ## Requirements
 
 - Bun >= 1.0.0
@@ -351,4 +366,4 @@ bunx mandu build --minify --sourcemap
 
 ## License
 
-MIT
+MPL-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",

package/src/commands/init.ts

@@ -462,6 +462,7 @@ export async function init(options: InitOptions = {}): Promise<boolean> {
   console.log(`\n🤖 AI 에이전트 통합:`);
   logMcpConfigStatus(".mcp.json", mcpResult!.mcpJson, "Claude Code 자동 연결");
   logMcpConfigStatus(".claude.json", mcpResult!.claudeJson, "Claude MCP 로컬 범위");
+  logMcpConfigStatus(".gemini/settings.json", mcpResult!.geminiJson, "Gemini CLI 자동 연결");
   console.log(`   AGENTS.md → 에이전트 가이드 (Bun 사용 명시)`);
 
   // Lockfile 안내
@@ -583,6 +584,7 @@ interface McpConfigFileResult {
 interface McpConfigResult {
   mcpJson: McpConfigFileResult;
   claudeJson: McpConfigFileResult;
+  geminiJson: McpConfigFileResult;
 }
 
 function logMcpConfigStatus(
@@ -619,7 +621,7 @@ function logMcpConfigStatus(
 }
 
 /**
- * .mcp.json / .claude.json 설정 (AI 에이전트 통합)
+ * .mcp.json / .claude.json / .gemini/settings.json 설정 (AI 에이전트 통합)
  * - 파일 없으면 새로 생성
  * - 파일 있으면 mandu 서버만 추가/업데이트 (다른 설정 유지)
  */
@@ -637,6 +639,8 @@ async function setupMcpConfig(
 ): Promise<McpConfigResult> {
   const mcpPath = path.join(targetDir, ".mcp.json");
   const claudePath = path.join(targetDir, ".claude.json");
+  const geminiDir = path.join(targetDir, ".gemini");
+  const geminiPath = path.join(geminiDir, "settings.json");
 
   const manduServer = {
     command: "bunx",
@@ -726,7 +730,11 @@ async function setupMcpConfig(
   const mcpJson = await updateMcpFile(mcpPath);
   const claudeJson = await updateMcpFile(claudePath);
 
-  return { mcpJson, claudeJson };
+  // Gemini CLI: .gemini/settings.json (프로젝트 스코프)
+  await fs.mkdir(geminiDir, { recursive: true });
+  const geminiJson = await updateMcpFile(geminiPath);
+
+  return { mcpJson, claudeJson, geminiJson };
 }
 
 interface LockfileResult {

package/templates/default/AGENTS.md

@@ -101,6 +101,19 @@ bun run build   # 프로덕션 빌드
 bun run guard   # 아키텍처 검증
 ```
 
+## AI 에이전트 MCP 설정
+
+이 프로젝트는 `@mandujs/mcp` MCP 서버를 통해 AI 에이전트와 통합됩니다.
+`mandu init` 시 자동으로 설정 파일이 생성됩니다:
+
+| 에이전트 | 설정 파일 | 비고 |
+|----------|-----------|------|
+| Claude Code | `.mcp.json` | 자동 연결 |
+| Claude Desktop | `.claude.json` | 로컬 범위 |
+| Gemini CLI | `.gemini/settings.json` | 자동 연결 |
+
+MCP 서버가 제공하는 도구: `mandu_negotiate`, `mandu_generate_scaffold`, `mandu_guard` 등
+
 ## 기술 스택
 
 - **Runtime**: Bun 1.x

package/templates/realtime-chat/AGENTS.md

@@ -88,6 +88,19 @@ bun run build   # 프로덕션 빌드
 bun run guard   # 아키텍처 검증
 ```
 
+## AI 에이전트 MCP 설정
+
+이 프로젝트는 `@mandujs/mcp` MCP 서버를 통해 AI 에이전트와 통합됩니다.
+`mandu init` 시 자동으로 설정 파일이 생성됩니다:
+
+| 에이전트 | 설정 파일 | 비고 |
+|----------|-----------|------|
+| Claude Code | `.mcp.json` | 자동 연결 |
+| Claude Desktop | `.claude.json` | 로컬 범위 |
+| Gemini CLI | `.gemini/settings.json` | 자동 연결 |
+
+MCP 서버가 제공하는 도구: `mandu_negotiate`, `mandu_generate_scaffold`, `mandu_guard` 등
+
 ## 기술 스택
 
 - **Runtime**: Bun 1.x