claude-mococo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 wodn5515
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,171 @@
+# claude-mococo
+
+**Discord 위의 AI 어시스턴트.** 각 어시스턴트는 AI 엔진(Claude, Codex, Gemini)으로 구동되는 실제 Discord 봇입니다. 고유한 GitHub 계정, 성격, 권한을 가집니다. 하나부터 시작해서 필요할 때 더 추가하세요.
+
+```
+나: "my-app에 로그인 페이지 만들어줘"
+
+어시스턴트 (봇): "알겠습니다. 인증 라우트와 로그인 폼을 만들게요."
+              → 코드 커밋 → 브랜치 푸시 → PR 생성
+```
+
+---
+
+## 빠른 시작
+
+### 1. 설치
+
+```bash
+npm install -g claude-mococo
+```
+
+AI 엔진도 최소 하나 필요합니다:
+
+```bash
+claude --version                  # Claude CLI (추천)
+npm install -g @openai/codex      # Codex CLI (선택)
+npm install -g @google/gemini-cli # Gemini CLI (선택)
+```
+
+### 2. Discord 봇 만들기
+
+1. [discord.com/developers/applications](https://discord.com/developers/applications) → **New Application**
+2. 이름 지정 (예: `my-assistant`)
+3. 사이드바 → **Bot**:
+   - 봇 토큰 복사
+   - **Privileged Gateway Intents** 3개 모두 활성화 (Presence, Server Members, **Message Content**)
+4. 사이드바 → **OAuth2**:
+   - Scopes: `bot`
+   - Permissions: `Send Messages`, `Read Message History`, `Embed Links`, `Attach Files`
+   - URL 복사 → 브라우저에서 열기 → 서버에 추가
+
+### 3. 워크스페이스 생성 및 어시스턴트 추가
+
+```bash
+mkdir my-team && cd my-team
+mococo init                   # 워크스페이스 생성 (Discord 채널 ID 입력)
+mococo add                    # 대화형 마법사 — 이름, 엔진, 토큰 등 입력
+```
+
+커밋에는 어시스턴트 이름이 작성자로 표시됩니다 (`teams.json`의 `git.name`으로 설정). 어시스턴트가 푸시나 PR을 생성해야 하면 `mococo add` 시 GitHub PAT를 입력하세요.
+
+### 4. 저장소 연결 및 시작
+
+```bash
+ln -s /경로/my-app repos/my-app
+mococo start
+```
+
+Discord 채널에서 봇에게 말을 걸면 됩니다.
+
+---
+
+## CLI 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `mococo init` | 현재 디렉토리에 워크스페이스 생성 |
+| `mococo add` | 어시스턴트 추가 (대화형 마법사) |
+| `mococo start` | 모든 어시스턴트 시작 |
+| `mococo list` | 설정된 어시스턴트 목록 |
+| `mococo remove <id>` | 어시스턴트 제거 |
+
+---
+
+## 어시스턴트 추가하기
+
+```bash
+mococo add        # 새 어시스턴트마다 반복
+```
+
+각 어시스턴트는:
+- 고유한 Discord 봇 (채팅에서 별도 신원)
+- 고유한 git 작성자 이름 (커밋 메시지에 표시)
+- `teams.json`의 별도 항목 (엔진, 성격, 권한)
+
+이렇게 팀을 구성할 수 있습니다:
+
+| 어시스턴트 | 엔진 | 역할 |
+|-----------|------|------|
+| Leader | Claude | 다른 어시스턴트에게 작업 위임 |
+| Planner | Codex | 계획 및 스펙 작성 |
+| Coder | Claude | 코드 작성 |
+| Reviewer | Claude | 리뷰 및 PR 생성 |
+| Designer | Gemini | UI/UX 가이드 |
+
+혼자 하나만 써도 됩니다. 선택은 자유입니다.
+
+---
+
+## 작동 방식
+
+**메시지 라우팅:**
+- 특정 봇을 `@멘션` → 해당 어시스턴트가 응답
+- 멘션 없음 → `"isLeader": true`인 어시스턴트가 응답
+
+**어시스턴트가 다른 어시스턴트를 멘션하면** (예: `@Reviewer 확인 부탁`) → 자동으로 호출됩니다.
+
+**권한**은 `teams.json`에서 어시스턴트별로 제어합니다:
+
+```jsonc
+"permissions": {
+  "allow": ["git push", "gh pr create"],
+  "deny": ["gh pr merge"]
+}
+```
+
+**엔진:** `"claude"`는 풀 에이전트(파일, git, 명령어). `"codex"`와 `"gemini"`는 텍스트 전용 어드바이저.
+
+---
+
+## 설정 레퍼런스
+
+### teams.json 필드
+
+| 필드 | 설명 |
+|------|------|
+| `engine` | `"claude"`, `"codex"`, 또는 `"gemini"` |
+| `model` | 모델명 (예: `"sonnet"`, `"opus"`, `"o3"`, `"gemini-2.5-pro"`) |
+| `maxBudget` | 호출당 최대 비용 (Claude만 해당) |
+| `prompt` | 성격/지시사항 파일 경로 |
+| `isLeader` | `true`면 모든 메시지에 응답 (@멘션 불필요) |
+| `git.name` / `git.email` | 커밋 작성자 정보 |
+| `permissions.allow` / `permissions.deny` | 허용/차단 쉘 명령어 |
+
+### Discord 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `!status` | 모든 어시스턴트 상태 (작업 중/유휴, 온라인/오프라인) |
+| `!teams` | 어시스턴트 목록과 엔진 |
+| `!repos` | 연결된 저장소 목록 |
+
+---
+
+## 수동 설정 (CLI 없이)
+
+저장소를 직접 클론해서 설정할 수도 있습니다:
+
+```bash
+git clone https://github.com/anthropics/claude-mococo.git
+cd claude-mococo
+npm install
+```
+
+`teams.json`을 직접 편집하고, `prompts/`에 프롬프트 파일을 만들고, `.env`에 토큰을 설정한 후 `npm start`로 실행합니다.
+
+---
+
+## 문제 해결
+
+| 문제 | 해결 |
+|------|------|
+| 봇이 응답 안 함 | Discord Developer Portal에서 **Message Content Intent** 활성화 |
+| "No team has a Discord token" | `.env`에 토큰 환경변수 추가 |
+| GitHub 푸시 불가 | `.env`의 GitHub PAT 확인 |
+| 커밋 작성자 틀림 | `git.email`을 `USERNAME@users.noreply.github.com`으로 설정 |
+| "command not found: codex" | 설치하거나 engine을 `"claude"`로 변경 |
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,180 @@
+# claude-mococo
+
+**AI assistants on Discord.** Each assistant is a real Discord bot backed by an AI engine (Claude, Codex, Gemini). It has its own GitHub account, personality, and permissions. Start with one, add more when you need them.
+
+```
+You: "Add a login page to my-app"
+
+Assistant (bot): "On it. I'll create the auth routes and login form."
+               → commits code → pushes branch → opens PR
+```
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g claude-mococo
+```
+
+Or run directly without installing:
+
+```bash
+npx claude-mococo init
+npx claude-mococo add
+npx claude-mococo start
+```
+
+You also need at least one AI engine:
+
+```bash
+claude --version                  # Claude CLI (recommended)
+npm install -g @openai/codex      # Codex CLI (optional)
+npm install -g @google/gemini-cli # Gemini CLI (optional)
+```
+
+### 2. Create a Discord bot
+
+1. Go to [discord.com/developers/applications](https://discord.com/developers/applications) → **New Application**
+2. Name it anything (e.g. `my-assistant`)
+3. Sidebar → **Bot**:
+   - Copy the bot token
+   - Enable all three **Privileged Gateway Intents** (Presence, Server Members, **Message Content**)
+4. Sidebar → **OAuth2**:
+   - Scopes: `bot`
+   - Permissions: `Send Messages`, `Read Message History`, `Embed Links`, `Attach Files`
+   - Copy the URL → open in browser → add to your server
+
+### 3. Initialize and add your assistant
+
+```bash
+mkdir my-team && cd my-team
+mococo init                   # creates workspace (asks for Discord channel ID)
+mococo add                    # interactive wizard — asks for name, engine, tokens, etc.
+```
+
+Commits will show the assistant's name as the author (configured via `git.name` in `teams.json`). If you need assistants to push or create PRs, provide your GitHub PAT during `mococo add`.
+
+### 4. Link your repos and start
+
+```bash
+ln -s /path/to/my-app repos/my-app
+mococo start
+```
+
+Talk to your bot in the Discord channel. Done.
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `mococo init` | Create a new workspace in the current directory |
+| `mococo add` | Add an assistant (interactive wizard) |
+| `mococo start` | Start all assistants |
+| `mococo list` | List configured assistants |
+| `mococo remove <id>` | Remove an assistant |
+
+---
+
+## Adding More Assistants
+
+```bash
+mococo add        # repeat for each new assistant
+```
+
+Each one gets:
+- Its own Discord bot (separate identity in chat)
+- Its own git author name (visible in commit messages)
+- Its own entry in `teams.json` (engine, personality, permissions)
+
+You can build a full team this way:
+
+| Assistant | Engine | Role |
+|-----------|--------|------|
+| Leader | Claude | Delegates work to other assistants |
+| Planner | Codex | Creates plans and specs |
+| Coder | Claude | Writes code |
+| Reviewer | Claude | Reviews and opens PRs |
+| Designer | Gemini | UI/UX guidance |
+
+Or just run a single assistant. It's up to you.
+
+---
+
+## How It Works
+
+**Message routing:**
+- If you `@mention` a specific bot → that assistant responds
+- If no mention → the first assistant marked `"isLeader": true` responds
+
+**When an assistant mentions another** (e.g. `@Reviewer please check this`) → that assistant is automatically invoked.
+
+**Permissions** are controlled per-assistant in `teams.json`:
+
+```jsonc
+"permissions": {
+  "allow": ["git push", "gh pr create"],
+  "deny": ["gh pr merge"]
+}
+```
+
+**Engines:** `"claude"` runs as a full agent (files, git, commands). `"codex"` and `"gemini"` run as text-only advisors.
+
+---
+
+## Configuration Reference
+
+### teams.json fields
+
+| Field | Description |
+|-------|-------------|
+| `engine` | `"claude"`, `"codex"`, or `"gemini"` |
+| `model` | Model name (e.g. `"sonnet"`, `"opus"`, `"o3"`, `"gemini-2.5-pro"`) |
+| `maxBudget` | Max dollar spend per invocation (Claude only) |
+| `prompt` | Path to the personality/instructions file |
+| `isLeader` | If `true`, responds to all messages (not just @mentions) |
+| `git.name` / `git.email` | Git author for commits |
+| `permissions.allow` / `permissions.deny` | Allowed/denied shell commands |
+
+### Discord commands
+
+| Command | Description |
+|---------|-------------|
+| `!status` | Show all assistants (busy/idle, online/offline) |
+| `!teams` | List assistants and their engines |
+| `!repos` | List linked repositories |
+
+---
+
+## Manual Setup (without CLI)
+
+You can also set up manually by cloning the repo:
+
+```bash
+git clone https://github.com/wodn5515/claude-mococo.git
+cd claude-mococo
+npm install
+npm run build
+```
+
+Edit `teams.json` directly, create prompt files in `prompts/`, set tokens in `.env`, then `npm start`.
+
+---
+
+## Troubleshooting
+
+| Problem | Fix |
+|---------|-----|
+| Bot doesn't respond | Enable **Message Content Intent** in Discord Developer Portal |
+| "No team has a Discord token" | Add the token env var to `.env` |
+| Can't push to GitHub | Check the GitHub PAT in `.env` is valid |
+| Wrong commit author | Set `git.email` to `USERNAME@users.noreply.github.com` |
+| "command not found: codex" | Install it or change engine to `"claude"` |
+
+## License
+
+MIT

package/defaults/shared-rules.md

@@ -0,0 +1,70 @@
+## Common Rules
+
+### Priority
+**Rules > Role > Personality** — Rules always override personality when in conflict.
+On conflict: stop → verify → propose alternative → execute after approval.
+
+### Hierarchy
+{{humanTitle}} > {{leaderName}} > Self. Superiors' instructions always take priority.
+
+### Absolute Prohibitions
+- PR merge — only {{humanTitle}} can do this
+- Exposing tokens, passwords, or credentials
+- Tagging your own Discord ID
+
+### Tag Response Judgment
+Being tagged doesn't always require a response. Judge the context:
+- **Speaking to me** (question, instruction, request) → respond
+- **Merely mentioning me** (talking about me to a third party) → no response needed
+
+### Conversation End Judgment
+Only tag someone when you **have something to say**. End without tagging if:
+- Ceremonial responses (greetings, thanks, acknowledgments) → end without tag
+- Other party already completed/approved and **no further discussion needed** → end
+- **Repeating** the same topic → end
+- No new information, questions, or work to delegate → end
+
+**Principle: Tag = only when the other party needs to take action. A reaction emoji is enough otherwise.**
+
+### {{humanTitle}} Tagging Rules
+Tag {{humanTitle}} **minimally**. Only tag when:
+- Answering {{humanTitle}}'s **direct question/instruction**
+- A matter **requiring approval** (PR merge, critical decisions)
+- An **urgent issue** only {{humanTitle}} can resolve
+
+For other reports, progress updates, general questions → **tag {{leaderName}}**. {{leaderName}} will relay to {{humanTitle}} if needed.
+
+### Behavior Principles
+- **Stop if uncertain** — don't guess, ask {{leaderName}}
+- **Report failures immediately** — explain the situation to {{leaderName}}
+- **Be concise** — Discord messages should be to the point. No essays
+- **When handing off work** — @mention + 1-line summary + background/requirements
+- **Keep casual conversation natural** — In non-work conversations (greetings, welcomes, chat), don't use instructional or explanatory tone. Talk like a person. No directives like "please do X". If you have nothing to say, don't say it.
+
+### Memory Rules
+- **All in-progress tasks and waiting items must include `#ch:channelId`.** The auto-loop needs the channel ID to determine where to continue work.
+- Without a channel ID, the loop may skip or malfunction.
+
+### Default Honorifics
+- {{humanTitle}}: respectful/formal language
+- {{leaderName}}: defined per agent in Character section (default: respectful)
+- Other agents: defined per agent in Character section
+
+### New Agent Welcome Protocol
+When a new agent joins the server, the system generates a `[New Agent Joined]` message.
+Follow this sequence strictly. **Do not tag multiple agents at once.**
+
+**Step 1 — {{leaderName}} (on receiving system message):**
+- Tag **only** the new agent and request an introduction
+- Do not tag other agents at this step
+
+**Step 2 — New agent (when tagged):**
+- Self-introduction: name, role, responsibilities
+- One-liner commitment: how they'll contribute to the team
+- Tag {{leaderName}} to respond (tag rules auto-invoke {{leaderName}})
+
+**Step 3 — {{leaderName}} (after confirming introduction):**
+- Tag other agents and ask them to welcome the newcomer
+
+**Step 4 — Other agents (when tagged):**
+- Welcome message or a welcoming emoji reaction like `[discord:react emoji=👋]`

package/dist/bot/client.d.ts

@@ -0,0 +1,10 @@
+import { Client } from 'discord.js';
+import type { TeamsConfig, TeamConfig, EnvConfig, ConversationMessage, ChainContext } from '../types.js';
+export declare const teamClients: Map<string, Client<boolean>>;
+export declare function appendToInbox(teamId: string, from: string, content: string, workspacePath: string, channelId: string): Promise<void>;
+export declare function clearInbox(teamId: string, workspacePath: string): void;
+export declare function newChain(): ChainContext;
+export declare function sendAsTeam(channelId: string, team: TeamConfig, content: string): Promise<boolean>;
+export declare function createBots(config: TeamsConfig, env: EnvConfig): Promise<void>;
+export declare function handleTeamInvocation(team: TeamConfig, triggerMsg: ConversationMessage, channelId: string, config: TeamsConfig, env: EnvConfig, chain?: ChainContext, continuationCount?: number): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/bot/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/bot/client.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,MAAM,EAEP,MAAM,YAAY,CAAC;AAcpB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAUzG,eAAO,MAAM,WAAW,8BAA4B,CAAC;AA8CrD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAuCpH;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,QAS/D;AAMD,wBAAgB,QAAQ,IAAI,YAAY,CAOvC;AA4HD,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBvG;AAoBD,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkXnF;AAmFD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,SAAS,EACd,KAAK,GAAE,YAAyB,EAChC,iBAAiB,SAAI,iBA6BtB"}