# ChatGPT ↔ Claude Code bridge

Einfalt v1 workflow þar sem GitHub geymir verkefni og kóðabreytingar en MCP sér um staðbundna röð, stöðu og skilaboð.

```text
User → ChatGPT → task/issue → Claude Code → branch/commit/PR → result → ChatGPT review → user
User → Claude Code → task/issue → ChatGPT/Codex → branch/commit/PR → result → Claude Code review → user
```

## Hlutverk

- **GitHub er source of truth:** Issues geyma verkefnalýsingu og samþykktarskilyrði. Verkefnarepo geymir branch, commit og pull request. PR og `results/` geyma niðurstöðu.
- **MCP er flutningslag:** Verkfærin `create_task`, `get_task`, `list_tasks`, `claim_task`, `complete_task`, `add_message` og `get_messages` halda utan um staðbundna vinnuröð.
- **Þetta repo geymir protocol og MCP-þjóninn.** Kóðavinna fer fram í því project-repo sem task vísar á.

## Uppsetning

Kröfur: Python 3.10+, `mcp` Python pakkinn, GitHub CLI (`gh`) og Claude Code.

```powershell
python -m pip install "mcp>=2,<3"
claude mcp add chatgpt-claude-bridge --scope user -- python "<absolute-repo-path>/plugins/chatgpt-claude-bridge/server.py"
claude mcp get chatgpt-claude-bridge
```

User scope og sjálfgefna `~/.chatgpt-claude` state-mappan eru viljandi: Claude Code og ChatGPT/Codex vinna í mörgum project-repo-um en þurfa alltaf að sjá sömu task-röðina. Ekki bæta við project-scoped þjónustu með sama nafni eða stilla annan `CHATGPT_CLAUDE_STATE_DIR`; það getur myndað aðra state-skrá.

## Notkun

1. Upphafsaðili býr til GitHub Issue í réttu repo-i og kallar `create_task` með `requested_by` og `assigned_to`.
2. Móttakandi finnur sín `pending` task með `list_tasks(assigned_to=...)` og kallar `claim_task`.
3. Móttakandi les issue, vinnur á nýjum branch í `project_repo`, prófar breytinguna og opnar PR.
4. Móttakandi kallar `complete_task` með branch, commit SHA, PR-slóð og stuttri niðurstöðu.
5. Upphafsaðili reviewar PR og notar `add_message` ef lagfæringa er þörf.
6. Eftir samþykki notanda er PR sameinað samkvæmt reglum verkefnareposins.

Venjuleg gildi eru `chatgpt` → `claude-code`. Fyrir öfuga leið notar Claude Code `requested_by="claude-code"` og `assigned_to="chatgpt-codex"`.

Nánari samningur er í [config/protocol.md](config/protocol.md). MCP-staðan er sjálfgefið geymd í `~/.chatgpt-claude/bridge.sqlite3` svo Claude Code og ChatGPT/Codex sjái sömu röðina. Hún fer ekki í Git.

## Möppur

- `tasks/` — handoff-sniðmát og sýnidæmi; GitHub Issues eru lifandi task-skráin.
- `results/` — varanlegar niðurstöðusamantektir þegar þeirra er þörf.
- `config/` — protocol og staðbundin runtime-staða.
- `plugins/chatgpt-claude-bridge/` — MCP-þjónn og Codex/ChatGPT plugin manifest.

Upphaflegi textinn var: „Þetta er upphafið af einhverju stórkostlegu“.