้ขๅ Codex ไธ ChatGPT ๆก้ข็ซฏ็่ฝป้็บงๆ ไพตๅ
ฅๅฎๆถๅๅๅทฅไฝๅบไธไธไธๆๆฅๅๅๆญฅไธญๆขใ
ๅๅซโๅไบไบ็ธ็ฉไบๆ AI ๆๆกฃไบง็่ฏฏๅทฎโ๏ผๅฎ็ฐ็ ๅๅข้ๅฏน่ฏไธไธๆไธๆ็ปด้พ็ๆฏซ็ง็บงๆ ๆๅฏน้ฝใ
Seamless Real-time Collaboration Workspace & Context Hub for Codex & ChatGPT Desktop.
Stop cascading errors from tossing static AI docs. Align reasoning chains and context instantly across engineering teams.
ๅจ็ ๅๅข้ๅ จๅไฝฟ็จ Codex / ChatGPT ่ฟ่ก็ผ็ ไธๆถๆๆปๅๆถ๏ผไธชไบบๅๅ ตไฝๆๆ็ๆพ่ๆๅ๏ผไฝๅข้ๅไฝๅดๆปๅ ฅไบๆฐ็ๆณฅๆฝญ๏ผ
- ็็นไธ๏ผๅไบไบ็ธโ็ฉไบๆ AI ๆๆกฃโ๏ผๅฏผ่ด่ฏฏๅทฎไธๅนป่งๅฑๅฑๆพๅคง
ๆๅ ธๅ็็ฟป่ฝฆ็ฐๅบ๏ผๅไบ A ้ฎๅฎ AI๏ผ็ดๆฅๆ AI ๅๅบ็ไธๅคง็ฏๆช็ปๅฎๆต้ช่ฏ็ Markdown/Word ๆนๆกๆๆฅๅฃ่ๆกๆๅ โ็ฉโ็ปๅไบ Bใๅไบ B ๆฟๅฐ่ฟไปฝไบๆๆๆกฃๅๅปๅ็ป่ชๅทฑ็ๆฌๅฐ AI๏ผๅฏผ่ดไธคๅฐๆบๅจๅจๅ ๆปกๅๅฎๆกไปถๅ่ๅไปฃ็ ็ๅๆไธไบๆฌกๆผ็ป๏ผๅนป่งไธ่ฏฏๅทฎ่ขซๆๆฐ็บงๆพๅคง๏ผ่่ฐไธ็บฟๆถ้ข้ข่ธฉๅไบ็ธๆฏ็ฎใ - ็็นไบ๏ผไธขๅคฑๅๅ ๅๆไธๅณ็ญ้พ่ทฏ๏ผThe Missing "Why"๏ผ
้ๆๆๆกฃๅชๅ็ฐไบ AI ๆ็ปๅๅบ็ไธไปฝโ็ไผผๅทฅๆดโ็็ปๆ๏ผๅดๆนๅนณไบๆๅ ถๅ ณ้ฎ็ๆๆฏๆจๅฏผ่ๆฏโโโๆ้คไบๅชไบ่ธฉๅๆนๆก๏ผๅบๅฑ้ๅ็่พน็ไพ่ตๆฏไปไน๏ผPrompt ็ปๅ่ฟๅชไบ็บ ๅ๏ผโๆฅๆ็ๅไบ้ขๅฏนๅฐๅท้ๆๆๆฌ๏ผๆ นๆฌๆ ๆณ็่งฃๅ็ฝฎ่ฎพ่ฎกๆๅพใ - ็็นไธ๏ผPrompt ๅญคๅฒไธ้ๅค่ฏ้
ๅไบ A ่ฑ่ดนๅๅคฉๅ AI ็่พไบๅคๆไธๅก่งๅๅนถ่ฐไผๅบๆ้ไธไธๆ๏ผๅไบ B ๆฅๆ็ธๅ ณๆจกๅๆถๅ ถๆฌๅฐ AI ไพ็ถๅคไบโๅคฑๅฟโ็ถๆ๏ผๅช่ฝ้ๆฐ็ผๅ Prompt ไป้ถ่ธฉๅ๏ผ้ๅคๆถ่ๅคง้ Token ไธๅทฅๆถๅฟๆบใ - ็็นๅ๏ผ่ๅคฉๅทฅๅ
ทๆๅทฅๆฌ่ฟไฝๆไธๆๆๆณๅฏ
ไผ ็ป็ๅพฎไฟก/้ฃไนฆๆชๅพๆๅคงๆฎตๆๆฌๆท่ด๏ผไธไป ไฟกๆฏ่กฐๅไธฅ้๏ผ่ไธๆๆๅจๅช่ดดๆฟไธญๆๅคๆณ้ฒๆฌๅฐๅทฅ็จ็ปๅฏน่ทฏๅพใ็ฏๅขๅ้็่ณ Shell ๅฝไปค่กๅฏ็ ใ
TeamCodex ็ๆ ธๅฟ่งฃๆณ๏ผไปฅโ็ๅฎๅจๆไธไธๆๅฟซ็
งโๅฝปๅบๅไปฃโ็ฉไบๆ้ๆๆๆกฃโ๏ผ
TeamCodex ๅฐ AI ็ๅจๆๅค่ฝฎๆจ็้พ่ทฏ๏ผContext Chain๏ผ ่ฝฌๅไธบๅ Git Commit ไธๆ ทๅฏๆฒๆทใๅฏ่ฑๆใๅฏ็ง็บงๆฅๅ็ๅข้็บง่ตไบงใ
- ๅ็ๅ ๅต๏ผ้่ฟ CDP ๅ่ฎฎๆ ไพตๅ ฅๆ่ฝฝๅจ Codex / ChatGPT ๅฎๆนๅฎขๆท็ซฏไพงๆ ๏ผไธ็ ดๅๅ็ไฝฟ็จไน ๆฏ๏ผ
- ไธ้ฎ่ฑๆๅฟซ็ ง๏ผ้ๆถๅฐๅฝๅไผ่ฏๆๅ ไธบ่ชๅจ่ฟๆปคๆฌๅฐ็งๅฏ่ทฏๅพ็ๅไฝๅฟซ็ ง๏ผ
- ็ง็บงไธไธๆๅฏน้ฝ๏ผๅไฝ่ ๅจ่ชๅทฑ็ต่ไธไธ้ฎ็นๅปใๅฏผๅ ฅใ๏ผๅฎๆด็ๅค่ฝฎๆ่่ฟ็จๅณๅปๆณจๅ ฅๅฝๅๆดปๅจๅฏน่ฏ๏ผ่ฎฉๅ จๅข้็ AI ๅง็ป่ฟ่กๅจ**ๅฎๅ จ็ปไธ็ไบๅฎๅบๅ้ข๏ผSingle Source of Truth๏ผ**ไธ๏ผไปๆ นๆบไธๆถ็ญไผ ่ฏ่ฏฏๅทฎใ
ๆฏไฝๆๅๆฅๆๅฎๅ จ็ฌ็ซ็ๆฌๅฐ AI ไผ่ฏ่พน็๏ผๅจๅ็ซฏ้่ฟ CDP ๆ่ฝฝ Team ๅทฅไฝๅบ่ฟๆฅๅไธไธช Hubใๆๅ้่ฟๅไธไธช Hub ไบคๆขๅทฒๅไบซ็ไผ่ฏๅฟซ็ งไธๅไฝ่ตไบง๏ผๆฏไธชไบบ่ชไธปๅณๅฎๆๅชไบๅ ๅฎนๅฏผๅ ฅ่ชๅทฑ็ AI ไผ่ฏไธญใ
ๆไธๆฌกๅไฝๆต่ฝฌๆฅ่ฏปๅพ๏ผๆๅ A ้ๆฉไผ่ฏๅนถๅไบซ โ Hub ไฟๅญๅฟซ็ งๅนถๆจ้ๆดๆฐ็ปๅๆฟ้ดๆๅ โ ๆๅ B ๅจ Team ๅทฅไฝๅบๆฅ็ โ ๆๅ B ้ๆฉๆงๅฏผๅ ฅ่ชๅทฑ็ๆฌๅฐ AI ไผ่ฏใๅฎๆถๆจ้็ปไธไผ่ชๅจๆๆๆๅข้ๅฏน่ฏๆ ๅทฎๅซๅผบๅก่ฟๆฏไฝๆๅ็็งๆ AI ไผ่ฏไธญใ
- ๅฏน็ญๅๅๅไฝ๏ผๆฏไฝๆๅๆข่ฝๅไบซไน่ฝๅฏผๅ ฅ๏ผA ไธ B ๆฏๅนณ็ญ็ๅไฝ่ ๏ผไธ็ดๆฅๅๅนถๆฌๅฐๅบๅฑ็งๅฏไผ่ฏ๏ผ
- ไธฅๆ ผ็งๆ่พน็๏ผๆชๅไบซ็ไผ่ฏไธฅๆ ผไฟ็ๅจๆฌๆบ๏ผ็ปไธๅ ไธบๅ ๅ ฅๅข้ๆฟ้ด่ไบง็้ๅผๅๆญฅๆๆณ้ฒ๏ผ
- ๅไฝไธญๆข Hub๏ผๆฟ่ฝฝๅๆฟ้ดๅฃไปคไธๆๅๆ้ใๆถๆฏไธๅฟซ็ งใๅจ็บฟ็ถๆๆ็ฅ๏ผไปฅๅไปปๅก็ๆฟใ็ฅ่ฏๅบใ็ด ๆๅบๅๅทฅไฝๆฅๅ๏ผ
- ๆไน ๅไธๆไปถๅ ฅๅฃ๏ผHub ็ปไธๅจๆๅจๆบๅจๆไน ๅๅญๅจๆถๆฏใๅฟซ็ งไธไธไผ ๆไปถ๏ผๅฏ้็ Codex ๆไปถ๏ผSkills / Hook๏ผๅฏๆ้่ฏปๅ Hub ๆ่ฆๆณจๅ ฅๅฝๅไปปๅก๏ผ
- ๆฌๆบไผดไพฃๆ่ฝฝ๏ผไผดไพฃ็จๅบไธๆณจๅ ฅๅจ้่ฟ CDP ๆ่ฝฝ Team ๅทฅไฝๅบ๏ผCDP ไธๆฏ่ทจๆบๅจๅไฝ้้๏ผ่ทจๆบ้ไฟก็ปไธ็ฑ่ฝป้็บง HTTP API + SSE ๅ่ฎฎๆฟ่ฝฝใ
ๆฅ็็ข้ๅๅพ ยท ้จ็ฝฒ่ฏดๆ
็ปดๆคๅพ็๏ผ่ฟ่ก python3 scripts/generate_architecture_members.py๏ผๆ python3 scripts/generate_architecture_diagram.py๏ผ๏ผไฝฟ็จ Chrome / Chromium ่ชๅจ็ๆไธญ่ฑๆ็ข้ SVG ๅ 3200 ร 2240 ้ซๆธ
PNG๏ผๅฏ้่ฟ CHROME_BIN ๆๅฎๆต่งๅจ่ทฏๅพใ
ไปฅไธไธบ็ๅฎ็ฏๅขไธ Mac ๅฎฟไธปๆบ ไธ Windows 11 ๅๅ็ซฏ ็ๅ จๆฐๅ จๆฏๅ่ฏญๅฎๆบๆผ็คบ๏ผๅ จ้ฟ 80 ็ง๏ผๆถต็ๆฐ็็ๆฟ/็ด ๆๅบ/ๆ้ๆต่ฝฌๅ่ทจ็ซฏ็ง็บงไธไธๆๆณจๅ ฅ๏ผๅทฒๆ้ๅนถ้ ๆๅฎๆดๅ่ฏญๅญๅน่งฃ่ฏด๏ผ้ซๆธ ๅฎๆด่ง้ขๅ่ง docs/assets/teamcodex_demo.mp4๏ผ๏ผ
- ๐ 1. ไปปๅก็ๆฟไธๆ้ๆต่ฝฌ๏ผไปปๅกๅก็ๅค็ถๆ๏ผๅพ ๅค็ใ่ฟ่กไธญใๅทฒๅฎๆ๏ผๆๆฝๆต่ฝฌ๏ผๆฟ้ดๅฃไปคไธ่ง่ฒๆ้ๅณๆถ้ดๆ๏ผๅ จๅ็ถๆๆฏซ็ง็บงๅฎๆถๅๆญฅ๏ผ
- ๐ 2. ็ด ๆๅบไธๅคๆ ผๅผ้ไปถๅฏผๅ ฅ๏ผๆฏๆไปฃ็ ใๆๆกฃใๅพ็ไธๆไปถๅคนๅฟซ้ๆๆฝไธไผ ไธๅณๆถๅๅ๏ผๆๅปบๅข้็ปไธ็ ๅ็ฉๆๆฑ ๏ผ
- ๐ 3. Mac ็ซฏไธ้ฎ่ฑๆๅไบซ๏ผๅจ Codex ๅฎขๆท็ซฏไพง่พนๆ ็นๅปใๅไบซๅฏน่ฏใ๏ผ้ๆฉไปปๆๆๆฅๆๆปๅไผ่ฏ๏ผไธ้ฎ็ๆ่ฑๆๅฟซ็ งๅนถๅนฟๆญ๏ผ
- โก 4. Windows ็ซฏๆฏซ็ง็บงๆ็ฅไธๆ ๆๆฅๅ๏ผ่ๆๆบ/่ฟ็จๅๅ็ซฏ้ถๅปถ่ฟ่ชๅจไธๅฑๆฐๅก็๏ผๅไฝ่ ไธ้ฎใ้ๆฉๅฏน่ฏๅฏผๅ ฅใ๏ผ้ๅฎๆ็ปด้พไธไธไธๆ็ฌๆถๆณจๅ ฅๆฐไผ่ฏ๏ผๆ น้คไบๆฌกไผ ่ฏ่ฏฏๅทฎไธๆจกๅๅนป่งใ
ๅๅพ GitHub Releases ๆๆฐๅๅธ้กต ไธ่ฝฝๅฎๆนๅ็ๅฎ่ฃ ๅ ๏ผ
| ๅนณๅฐ | ๅฎ่ฃ ๅ | ไบคไบๅฝขๆไธไฝ้ช |
|---|---|---|
| macOS | TeamCodex-macOS.dmg |
ๆๅ
ฅ Applications ๅณๅฏใ็ถๆๆ ๅ
จ้ขๅ็บงไธบ็บฏ็ฝๅพฎ็ข้ๅไบๅๅๅพๆ ๏ผTemplate Icon๏ผ๏ผๅธฆ 1.7pt ่ด็ฉบ้ด็ซไฝๅ็ผไธ >_ ็ป็ซฏ้็ฉบ๏ผ่ช้ๅบๆทฑๆต
ๆจกๅผ๏ผ็นๅปๅผนๅบๅ็็ฃจ็ Mini Dashboard ๆฌๆตฎๅก็ |
| Windows | TeamCodex-Setup.exe |
่ฟ่กๅๅฏผ่ชๅจ้้ ARM64/AMD64๏ผๅธธ้ฉป็ณป็ปๆ็๏ผ้้ปๆฅ็ฎกๆ ้ปๆกใๅทฆ้ฎ็นๅปๅผนๅบๅ็ๆทฑ่ฒๆฌๆตฎๅก็๏ผๅคฑ็ฆ/Esc ่ชๅจๆถ่ตท๏ผ๏ผๅณ้ฎ็นๅปๅผนๅบ็บฏๅๅ็ไธไธๆ่ๅ๏ผ็นๅปใ้ๅบใ็ง้้ๅบๆ ๅกๆญป๏ผ๏ผๅ ทๅคๅ จๅฑๅๅฎไพ Mutex ไบๆฅ้ฒๅๅพๆ |
| ๅ ๅฎ่ฃ ไพฟๆบ็ | TeamCodex-macOS.zip / TeamCodex-Windows-arm64-amd64.zip |
่งฃๅๅณ็จ๏ผ้ๅ็งปๅจไป่ดจๆไธฅๆ ผๆ้็ฏๅข๏ผWindows ้ๅธฆ ้ๅบTeamCodex.cmd ๅบๆฅไธ้ฎๆธ
็ๅทฅๅ
ท |
| Codex ๅฎๆนๆไปถ | TeamCodex-Codex-Plugin.zip |
ๅฎๆนๆ ๅ Codex ๆไปถๅ
ใ่ตไบ AI ไธปๅจ่ฏปๅ็ฉบ้ด่ฝๅ๏ผ้ๆ UserPromptSubmit ่ชๅจ Hook ๆ่ฆๆณจๅ
ฅไธ้ข็ฝฎๆไปค |
ๆ็คบ๏ผๅฏๅจๅๅบ็จๅธธ้ฉป็ณป็ปๆ็/็ถๆๆ ๏ผ็นๅปๅณๅฏๅฑๅผ Mini Dashboard ๆงๅถ้ขๆฟ๏ผๅ ทๅค๏ผ
- ็ถๆ่ชๆฃ๏ผๅฎๆถๆพ็คบ Codex ๆ่ฝฝ็ถๆ๏ผ๐ข ๅทฒๆ่ฝฝ / ๐ก ็ญๅพ ๆ่ฝฝ / ๐ด ๆช่ฟๆฅ๏ผใไธญๆขๅฐๅไธๅจ็บฟๆฟ้ด๏ผ
- ไธ้ฎๆไฝ๏ผๆฏๆใๅฏๅจๅนถๆ่ฝฝ Codexใใใๅคๅถ Smart Tokenใใใๅๆขไธญๆขๅฐๅใไธใ้ๅฏๆณจๅ ฅใ๏ผ
- ๆ ๆ็ญๆดไธ็ๆฌๆฃๆต๏ผ่ชๅจๆๅๆๆฐไพงๆ ๆณจๅ ฅ่ๆฌ๏ผๆฃๆตๅฐๅบๅฑๆฐ็ๆฌๆถๆฏๆไธ้ฎไธ่ฝฝ๏ผ
- ไผ้ ้ๅบ๏ผๅณ้ฎ่ๅๆไพ็บฏๅ้ๅบ้้กน๏ผ็ณป็ป็บงๅผบๆๅฝปๅบๆถ็ญๅๅฐๅญค็ซ่ฟ็จใ
ไธญๆขๆๅก๏ผHub๏ผๆฏๆไปๆฌๅฐๅๆบๅฐ็งๆไบ็ไธ็ง่ฟ่กๆจกๅผ๏ผ
| ๆจกๅผ | ่ฟ่กไฝ็ฝฎ | ๅฎขๆท็ซฏๆฅๅ ฅๆนๅผ | ้็จๅบๆฏ |
|---|---|---|---|
| ๅๆบ่ทจ็ซฏ๏ผ้ป่ฎค๏ผ | Mac ๅฎฟไธปๆบๅๅฐ้้ป่ชๅฏ | Windows ่ๆๆบ่ชๅจๆขๆตๅฎฟไธปๆบ IP ็ด่ฟ | Mac + Win ่ๆๆบๆฌๅฐๅผๅ๏ผ้ถ้ ็ฝฎ๏ผ |
| ๅฑๅ็ฝๅๅ | ๅๅ ฌๅฎคๅ ๅธธๅผ PC / Mac / NAS | ๅกซๅ ฅ่ฏฅไธปๆบๅฑๅ็ฝ IP ๆ็ฒ่ดด Smart Token | 5 ~ 30 ไบบๅๅ ็ฝ/ๅ Wi-Fi ็ ๅๅฐ็ป |
| ไบ็ซฏๅ ฌ็ฝ้จ็ฝฒ | Linux ไบๆๅกๅจ (VPS) | ็ปๅฎๅๅๅนถ้่ฟ Nginx HTTPS ๅไปฃๆฅๅ ฅ | ่ทจๅฐๅใ่ฟ็จๅๅ ฌ็ๅๅธๅผๅข้ |
curl -fsSL https://raw.githubusercontent.com/we1jia/TeamCodex/main/scripts/deploy-hub.sh | bash่ๆฌๆบ่ฝๆขๆต็ณป็ป็ฏๅขไธๆ้๏ผไผๅ ้่ฟ Docker ๅฎนๅจๅๅฏๅจ๏ผๆ Docker ๆ้ๆถ่ชๅจ้็บง้็จๅ็ Node.js๏ผ้ถ npm ไพ่ต๏ผๆฏซ็ง็บงๅฏๅจ๏ผ๏ผ่ชๅจๆณจๅ SystemdใPM2 ๆ Crontab ๅผๆบ่ชๅฏๅฎๆค๏ผๅนถๆง่กๆฅๅฃ่ชๆฃใ
ไฝฟ็จ Claude CodeใCodexใCursorใOpenClaw ็ญ็ป็ซฏ AI ่ฟ็ปดๆๅกๅจๆถ๏ผ็ดๆฅๅคๅถไปฅไธๆ็คบ่ฏๅ้๏ผ
่ฏทๅธฎๆๅจๅฝๅๆๅกๅจ้จ็ฝฒ TeamCodex Hub ไธญๆขๆๅก๏ผ
1. ๆฃๆฅๆๅกๅจ็ฏๅข๏ผ้ๅ
ทๅค Docker ๆ Node.js >= 18๏ผHub ๆฏ็บฏๅ็ Node.js ๅฎ็ฐ๏ผ้ถ npm ไพ่ต๏ผ๏ผ
2. ๅๅคไปฃ็ ็ฎๅฝ๏ผ่ฅๆฏ root ็จๆทๅ
้่ณ /opt/TeamCodex๏ผ่ฅๆฏๆฎ้็จๆทๅ
้่ณ ~/TeamCodex๏ผ่ฅๅทฒๅญๅจๅ git pull๏ผ๏ผ
3. ๅฏๅจไธญๆขๆๅก๏ผ
- ่ฅๅ
ทๅค Docker ๅฎๆค่ฟ็จๆ้๏ผๆง่ก docker compose up -d๏ผ
- ่ฅๆ Docker ๆ้๏ผ็ดๆฅ่ฟ่ก node server/dev_host.mjs๏ผๅฏไฝฟ็จ pm2 ๆ nohup ๅฎๆค๏ผๅนถ้
็ฝฎๅผๆบ่ชๅฏ๏ผ๏ผ
4. ็ฝ็ปไธ็ซฏๅฃ๏ผๆๅก้ป่ฎค็ๅฌ 0.0.0.0:18765๏ผ่ฅๆฏไบๆๅกๅจ็ด่ฟ่ฏท็กฎไฟๅฎๅ
จ็ปๆพ่ก 18765 ็ซฏๅฃ๏ผ
5. ้ช่ฏๅฅๅบทๅบฆ๏ผๆง่ก curl http://127.0.0.1:18765/api/health ็กฎไฟ่ฟๅ {"ok":true}๏ผ
6. ่ฅๆ Nginx ๅไปฃ๏ผไปฃ็่ณ http://127.0.0.1:18765๏ผ้
็ฝฎไธญๅฟ
้กปๅ
ๅซ proxy_buffering off; ไปฅไฟ่ฏ SSE ๆตๅผๆจ้ๆญฃๅธธ๏ผ
7. ่พๅบๆฌๆบ็่ฎฟ้ฎๅฐๅ๏ผๅ
็ฝ/Tailscale/ๅ
ฌ็ฝ๏ผไธ็ณป็ป้ป่ฎค็ฉบ้ดๅฃไปค๏ผๅฆ Hub: http://<IP>:18765 | Room: Media๏ผใ
ๅฎๆดๅๆฐ่กจใDocker ็ผๆ้ ็ฝฎไธ Nginx SSL ๆจกๆฟๅ่ง๏ผไธญๆข้จ็ฝฒไธ็ฝ็ปๆฅๅ ฅๅ จๆฏๆๅ (docs/HUB_DEPLOYMENT.md)ใ
- ๅ จๅ่ฝๅข้ๅทฅไฝๅบ๏ผ็ๆฟ / ็ฅ่ฏๅบ / ็ด ๆๅบ / ๆฅๅ๏ผ๏ผๅ็ๆ ็ผ้ๆไปปๅกๅๆ็ๆฟใ้ญ็ฏๅฎกๆ ธๆต่ฝฌใ็ฅ่ฏๅบๅ จๆๆฃ็ดขใSHA-256 ๅ ๅฎนๅฏปๅ็ด ๆๅบไธๅทฅไฝๆฅๅ๏ผ่ฎฉ AI ไผ่ฏไธๅทฅ็จ็ ๅ็ๅฝๅจๆ็ดงๅฏ้ญ็ฏใ
- ๅ็ๅ ๅตไธ่ๅๆ ไผดไพฃ๏ผๅบไบ CDP ๅจๆๆ่ฝฝไพงๆ ๏ผ้ ๅฅ macOS ่ๅๆ / Windows ๆ็ๆ็ฎ Mini Dashboard๏ผไธๆขๅ ไธปๅทฅไฝๅบใ
- ๅ ้่ฃ ๅ่ฝจ็ญๆดๆฐ๏ผ่ฟ้ไธญ Hub ๆถ๏ผไพงๆ ๆณจๅ ฅ่ๆฌๅฏๅจๆถ่ชๅจๅจๆไธๅๅนถ็ผๅญ็ๆ๏ผ90% ็ๆฅๅธธ่ฟญไปฃๅ ไธ่ฝฝๆฐๅ ๏ผๅบๅฑๅคๅฃณ็ด้ Releases ๆฃๆฅใ
- ้ซไบฎ็ๅฝๅจๆไบๆฅ๏ผๅ จๅฑๅไฝไธๅ็ไผ่ฏไฟๆๅ้้ซไบฎ๏ผๅๅๅๅฒๅฏน่ฏ 100% ๆขๅคๅ็้ซไบฎใ
- ่ทจๅนณๅฐๅค็ซฏ่ฏๅซไธๅฟ่ทณไฟๆดป๏ผ่ชๅจๆขๆต็ฝ็ปไธๆไฝ็ณป็ป๏ผๆบ่ฝๅบๅ
MacไธWin่ฎพๅค่บซไปฝ๏ผๆฏๆๅจ็บฟๅๅๅป้ไธๆดป่ทๅ่กจๅจๆๅนฟๆญใ - ่ฑๆๅฟซ็ งไธไธไธๆๆฅๅ๏ผไธ้ฎๆๅ ไผ่ฏๅนถๅ้คๆฌๅฐ่ทฏๅพไธ Shell ๅฝไปค๏ผๅไฝ่ ๅฏไธ้ฎๅฏผๅ ฅๅฝๅๆดปๅจๅฏน่ฏใ
- ๆบ่ฝๅๅๅฃไปค (Smart Token)๏ผๆฏๆๅฝขๅฆ
Hub: <URL> | Room: <Name> | Key: <Password>็ๅ่กๅฃไปค็ง็บงๅ ๅ ฅไธ้ขๆฟๅฟซๆทๅคๅถใ
้คไบไพไบบ็ฑปๅผๅ่
ไบคไบ็ๅทฆไพงๆ ๅทฅไฝๅฐไธ็ณป็ปๆ็ไผดไพฃๅค๏ผTeamCodex ๆทฑๅบฆ้ๆไบ Codex ๅฎๆนๆ ๅๆไปถไฝ็ณป๏ผๅ
ๅซ .codex-plugin/plugin.json ๆธ
ๅใskills/ ่ฏญไนๆ่ฝไธ hooks/ ็ๅฝๅจๆๆฆๆชๅจ๏ผใ
- ๅทฆไพงๆ
TeamTab๏ผไบบ็ฑป็ๆฟ๏ผ๏ผ็ปๅทฅ็จๅธไฝฟ็จใๆไพๆฒๆตธๅผๅ จๅฑ็พค่ใๅจ็บฟๆๅๅคดๅใๅคๆฟ้ดๅๆขใๅฟซ็ งๆถ้ด็บฟๆต่งไธๆๅจไธ้ฎๅฏผๅ ฅ๏ผ Team Codexๆไปถ๏ผAI ๆ่ไธ่ณๆต๏ผ๏ผ็ปๅฝๅไผ่ฏไธญ็ AI ๅฉๆไฝฟ็จใ่ตไบ Codex ่ฏปๅๅข้็ฉบ้ดใๆ็ผ่ฎจ่ฎบๆ่ฆใ่ชๅจๅๆญฅไธไธๆ็ Tool ่ฝๅ๏ผๅผๅ่ ๆ ้ๅๅฑ๏ผ็จ่ช็ถ่ฏญ่จๅณๅฏๆๆฅ AI ๅๅใ
ๅจ Codex ๅฏน่ฏๆกไธญ็ดๆฅ่พๅ ฅๆ็นๅปๆฐๆณก๏ผ
ๆๅผ Team Codex ๅข้ๅไฝ็ฉบ้ดใ
๐ ่ฐ่ตทๅๅไธญๆขไธๆฌๅฐๆงๅถๅฐ๏ผๅผๅฏผ่็ฆๅทฆไพงๆ Team ้ขๆฟ๏ผ่ฏปๅๅฝๅๅข้็ฉบ้ด็่ฎจ่ฎบๆ่ฆใ
๐ ่ชๅจ่ฐ็จ API ่ทๅๅข้ๅฝๅ็ฉบ้ด็ๆๅๅ ฑ่ฏใๆถๆๆนๆก็ๆฌไธๅ ณ้ฎๆ่ง๏ผๆ ็ผๆณจๅ ฅๅฝๅไปปๅก๏ผๆฅ็ๅฝๅๅข้็ฉบ้ด็ไปปๅก็ๆฟๅๆๅ่ฟๅบฆใ๐ ๆฑๆปๅๆไปปๅกใ่ด่ดฃไบบใๅฎกๆ ธไบบใ้ปๅกๅๅ ไธๅทฅไฝๆฅๅๅฎๆ๏ผๆ็ดขๅฝๅๅข้็ฉบ้ด็็ฅ่ฏๅบๅ็ด ๆๅบใ๐ ๅชๆฃ็ดขๅฝๅๆๅๆๆ่ฎฟ้ฎ็่ตๆไธ็ด ๆ๏ผไธ่ชๅจ่ฏปๅ็งไบบ่ตๆ๏ผๆ้ๅฎ็ไปปๅกๅ่ตๆๅผ็จๅฐๅฝๅ Codex ๅฏน่ฏใ๐ ็ๆๅธฆๆฅๆบ IDใ็ๆฌๅ่ฏปๅๆถ้ด็ๅฏ่ฟฝๆบฏ่็จฟ๏ผ็กฎ่ฎคๅๆพๅ ฅ Team ่พๅ ฅๆก๏ผไธ่ชๅจๅ้๏ผๆๅฝๅ Codex ๅฏน่ฏๅไบซๅฐๅข้็ฉบ้ดใ
๐ ่ชๅจๆๅ ๅฝๅๅค่ฝฎๆจ็้พๆก๏ผๅ้คๆฌๅฐๆๆ่ทฏๅพๅๅนฟๆญ่ณๅข้ไธญๆขใ
- ๆ้ฎๅ้้ปๆขๆต๏ผๅจ็จๆทๆฏๆฌกๅ Codex ๆไบคไปฃ็ ้ฎ้ขๅ๏ผHook ๅจ 1200ms ๅ
้้ป่ฏทๆฑ
http://127.0.0.1:18765/api/compact.txt๏ผ - ๆฏซ็ง็บงไธไธๆๆณจๅ
ฅ๏ผ่ชๅจๆๅๅข้ๆๆฐๅณ็ญไธๆๅๅๆด๏ผไฝไธบ
additionalContext้ๅผ้ๅธฆๅจๆ็คบ่ฏไธญ๏ผ่ฎฉ AI ็ๅ็ญๅง็ปๅปบ็ซๅจๅ จๅข้ๆๆฐ็ๅ ฑ่ฏไนไธ๏ผ - ้ซๅฏ็จไธ้ถ้ปๅก๏ผ่ฅๆฌๅฐๆๅฑๅ็ฝไธญๆขๆๆถๆชๅฏๅจๆๅ็่ถ ๆถ๏ผHook 0 ๆฏซ็ง้้ป่ทณ่ฟ๏ผ็ปไธ้ปๅกๅผๅ่ ็ๆฅๅธธ็ผ็ ใ
- ๆพๅผๅทฅไฝๅบๆฅ่ฏข๏ผ็ๆฟใ็ฅ่ฏๅบๅ็ด ๆๅบไธ่ขซ Hook ้้ปๆณจๅ ฅ๏ผๅชๆ็จๆทๆ็กฎๆฅ่ฏขๆ้ๆฉๅผ็จๆถ๏ผๆไปถๆ่ฏปๅๅฏนๅบๅทฅไฝๅบๆฐๆฎใ
- ๆบ็ ๅฎ่ฃ
๏ผๆจ่ๅผๅ่
๏ผ๏ผๅจ็ป็ซฏๆง่ก๏ผ
codex plugin add /path/to/TeamCodex
- ็ฆป็บฟๅฏผๅ
ฅ๏ผไป GitHub Releases ไธ่ฝฝ
TeamCodex-Codex-Plugin.zipๅนถๅจ Codex ๆไปถ็ฎก็็้ข็นๅปๅฏผๅ ฅ๏ผ - ็้ขๅผๅฏ๏ผๅจ Codex ๅฎขๆท็ซฏๅทฆไพงๅฏผ่ช่ฟๅ ฅใๆไปถใ-> ๆพๅฐใTeam Codexใ-> ๅผๅฏๅณไธ่ง็ดซ่ฒ Toggle ๅผๅ ณๅณๅฏใ
TeamCodex ไธไป ๅฎ็ฐไบไผ่ฏไธไธๆ็ๅฎๆถๆฅๅ๏ผๆดๅจๅฎขๆท็ซฏๅ ๅ็ๆ้ ไบๅด็ป AI ็ ๅๅ จ็ๅฝๅจๆ็่ฝป้็บงๅข้ๅทฅไฝๅบ๏ผๅๅซ็ข็ๅ็่ๅคฉ่ฎฐๅฝ๏ผ่ฎฉๆฏไธๆฌกๆๆฏๅณ็ญใ่ตๆๆฒๆทไธไปปๅกไบคไป้ฝๆๆฎๅฏๆฅใ
- ๅๆ็ๆฟๆต่ฝฌ๏ผๆธ ๆฐๅๅไธบใๅพ ๅผๅงใใใ่ฟ่กไธญใใใ็ญๅพ ๅฎกๆ ธใไธใๅทฒๅฎๆใๅๅคงๆต่ฝฌ้ถๆฎต๏ผ
- ๅ
จ็ปดๅบฆไปปๅกๅ
ๆฐๆฎ๏ผๆฏๆๆๆดพไธป่ฆ่ด่ดฃไบบใๅไฝ่
๏ผๆฏๆ่ทจ็ซฏๅค้๏ผๅฆๅๆถๆๆดพ
weijia(Mac)ไธweijia(Win)๏ผใไธๅฑๅฎกๆ ธไบบ๏ผ็ฒพ็กฎ่ฎฐๅฝ่ตทๆญขๆฅๆใๅฎกๆ ธๆฅๆใไผๅ ็บงใ้ปๅกๅๅ ใ้ชๆถ่ฆๆฑไธไบคไป่ฏดๆ๏ผ - ไธฅ่ฐจ้ญ็ฏๅฎกๆ ธๆบๅถ๏ผๆไบคๅฎกๆ ธๅฟ ้กปๆๅฎๅฎกๆ ธไบบๅนถๅกซๅไบคไปไบง็ฉ่ฏดๆ๏ผไป ๆๅฎๅฎกๆ ธไบบๅ ทๅคใ้่ฟใๆใ้ๅใๆ้๏ผ้ๅๅฟ ้กปๆณจๆๅ ทไฝๅๅ ๏ผๅฎกๆ ธไธญ็ถๆ้ๅฎไปฅ้ฒ็ฏกๆนใ
- ๅคๆ ผๅผ่ตๆ็บณ็ฎก๏ผๆฏๆ Markdown ๆๆกฃ็ผๅใไปฃ็ ็ๆฎตๅๅ็ฑป้ไปถไธไผ ๏ผๅๆไปถไธ้ 10MB๏ผๆญฃๆๅ จๆ็ดขๅผ่พพ 20 ไธๅญ็ฌฆ๏ผ๏ผๆฏๆๅ จๆๅฟซ้ๆฃ็ดขไธๅ็ฑป/ๆ ็ญพ่ฟๆปค๏ผ
- ็ป็ฒๅบฆๆ้ๆงๅถ๏ผ่ตๆๆฏๆใไป ๆๅฏ่งใ๏ผ็งไบบ่ตๆ๏ผไธใๅฝๅ้กน็ฎๅ ฑไบซใไธ้ฎๅๆข๏ผ็งไบบ่ตๆๅไธฅๆ ผ้ดๆไฟๆค๏ผ็ปไธ่ฟๅ ฅๅ ฌๅผๅนฟๆญไธๆง่ๅคฉๅฟซ็ ง๏ผ
- SHA-256 ๅ ๅฎนๅฏปๅๅค็จ๏ผ็ด ๆๅบไธ็ฅ่ฏๅบๅ ฑ็จ่ตๆๅบๅบง๏ผ็ธๅๅ ๅฎนๆไปถๆ SHA-256 ๆ่ฆ็ง็บงๅป้ๅค็จ๏ผๆไพๅฎๅ จ็ๅพ็ๅฐฑๅฐ้ข่งไธๅๆไปถไธ่ฝฝใ
- ๆฅ็จๅ จๆฏ็ๆฟ๏ผๆ นๆฎๆๅ็ฌ็ซ้ ็ฝฎ็ๆถๅบใๅทฅไฝๆฅไธไธๅฏ็จๆฅๆ่ชๅจๅ็ฐๆง่กไธๅฎกๆ ธๅฎๆ๏ผ
- ๆๆๆบ่ฝ้ข่ญฆ๏ผๆธ ๆฐๆ ่ฏ้ๅทฅไฝๆฅๆ้ใ้พๆไปปๅกๅ่ญฆไปฅๅๅพ ๆๆไปปๅกๆธ ๅ๏ผ้ฟๅ ๅทฅๆๅปถ่ฏฏใ
- ๅฎๅ จ็ปๆๅๅผ็จ๏ผๅจ Team ๅฏน่ฏไธญๅฏไธ้ฎ้ๆฉไปปๅกๆๅทฒๅ ฑไบซ่ตๆ๏ผ็ๆๅ ๅซๆฅๆบ IDใ็ๆฌไธๅฟซ็ ง่ฏปๅๆถ้ด็็ปๆๅไธไธๆ๏ผ
- ไบบ็ฑปๆ็ปๆๅ ณ๏ผ็กฎ่ฎคๅไป ๅกซๅ ฅ่พๅ ฅๆกไพๅฎกๆฅไฟฎๆน๏ผ็ปไธ่ชๅจ็ฒๅๆ่ถๆๆง่กๆไปค๏ผ็กฎไฟๅฎๅ จๅฏๆงใ
ๆจ้ main ๅไผ่ชๅจๆต่ฏใ้ๅข็ๆฌใๆๅ
ๅนถๅๅธ GitHub Release๏ผๆฎ้ๅๆฏๅ PR ๅช่ฟ่กๆฃๆฅใ่ฏฆ่ง่ชๅจๅๅธๆต็จใ
TeamCodex/
โโโ .codex-plugin/ # ๅฎๆน Codex ๆไปถๆธ
ๅไธๅ
ๆฐๆฎ (plugin.json)
โโโ hooks/ # ๆ้ฎๅ่ชๅจไธไธๆๆณจๅ
ฅ้ฉๅญ (UserPromptSubmit)
โโโ skills/ # ่ฏญไนๅๆ่ฝๆไปคๅฎไน (skills/team-codex/SKILL.md)
โโโ assets/ # ๆไปถไธๅฎขๆท็ซฏๅพๆ ใLogo ๅ็้ขๆๅพ
โโโ inject/ # CDP ๅฎขๆท็ซฏไพงๆณจๅ
ฅๅฑใWeb Component ไธๅ
จๅฑๅไฝ UI
โ โโโ sidebar_fullscreen.js # ไพงๆ ๅตๅ
ฅใๅฟซ็
ง่ฑๆไธๅๅ็ถๆๆบ
โ โโโ workspace.js # ๅทฅไฝๅบ๏ผ็ๆฟ/็ฅ่ฏๅบ/็ด ๆๅบ/ๆฅๅ๏ผๅ็ซฏ็ปไปถไธ็ถๆ็ฎก็
โ โโโ workspace.css # ๅ็ไธป้ข่ช้ๅบๆ ทๅผไธ็ดงๅๅๅบๅผๅธๅฑ
โ โโโ attach_codex.mjs # ๅจๆๆๅไธญๆขๆๆฐ่ๆฌใCDP ๆ่ฝฝไธๅฟ่ทณๅๆญฅ
โโโ server/ # ้ถไพ่ตๅ็ Node.js ๅไฝๆๅก
โ โโโ dev_host.mjs # SSE ๅฎๆถๅๅไธญๆข (18765็ซฏๅฃ๏ผๅจ็บฟไบบๆฐ/ๅคๆฟ้ด/้ดๆ)
โ โโโ workspace_store.mjs # ๅทฅไฝๅบๅๅญๅๅ
ฅไธ JSON ๆไน
ๅๅญๅจ
โ โโโ workspace_routes.mjs # ๅทฅไฝๅบ RESTful API ่ทฏ็ฑไธๆ้ๆ ก้ช
โ โโโ workspace_validation.mjs # ไปปๅก/่ตๆๅญๆฎตๅๆณๆงไธๅฎๅ
จ่ฟๆปคๆ ก้ช
โ โโโ launcher_host.mjs # ๆฌๅฐๆ็ๆงๅถ้ขๆๅก (18767็ซฏๅฃ๏ผ่ชๆฃ/ๆดๆฐ/ๅฃไปค)
โโโ ui/ # ๅ็ซฏ UI ่ตๆบ
โ โโโ index.html # ็ฌ็ซๅ
จๅฑๅไฝ็ฝ้กต็ซฏ
โ โโโ workspace.html # ๅทฅไฝๅบ็ฌ็ซๅ
ฅๅฃ้กต้ข
โ โโโ panel.html # ่ๅๆ /ๆ็ Mini Dashboard ๆฌๆตฎๆงๅถๅก็
โโโ macos/ # macOS ่ๅๆ ๅฎขๆท็ซฏไธๆๅ
ๅฅไปถ
โ โโโ TeamCodex.swift # ๅ็ Swift ็ถๆๆ ๅบ็จๆบ็ (Cocoa + WebKit)
โ โโโ TeamCodex-Status.png # ็บฏ็ฝๅพฎ็ข้ๅไบๅๅๅพๆ (Template Icon, ่ช้ๅบๆทฑๆต
ไธป้ข)
โ โโโ launch.sh # ่ฟ่กๆถ่ชๆฃไธๅฎๆค่ๆฌ
โ โโโ build_dmg.py # ่ชๅ
ๅซ DMG ๆๅปบๅจ (้ๆ swiftc ่ชๅจ็ผ่ฏ)
โโโ windows/ # Windows ๆ็ๅฅไปถไธ NSIS ๅฎ่ฃ
ๅ
ๅทฅ็จ
โ โโโ tray-teamcodex.ps1 # ๅ็็ณป็ปๆ็ๆงๅถๅฐ (ๅทฆ้ฎๅ็ๅผน็ช + ๅณ้ฎๅ็่ๅ)
โ โโโ run-teamcodex.ps1 # ๅฏๅจๅฎๆคไธๅๅฎไพ Mutex ไบๆฅๆฅ็ฎก
โ โโโ ้ๅบTeamCodex.cmd # [ๅบๆฅๅทฅๅ
ท] ไธ้ฎๅผบๆๆๆๅๅฐ่ฟ็จๅนถๆธ
็ๆ็
โ โโโ installer.nsi # NSIS ๅฎ่ฃ
ๅๅฏผ้
็ฝฎ
โโโ scripts/ # ่ฟ็ปดไธ่ชๅจๅ้จ็ฝฒ่ๆฌ (deploy-hub.sh)
โโโ docs/ # ๆถๆ่ฎพ่ฎกใๅทฅไฝๅบ่ง่ไธ็ฝ็ปๆฅๅ
ฅๅ
จๆฏๆๅ
โ โโโ WORKSPACE.md # ๅทฅไฝๅบๆฐๆฎๆจกๅใๆ้ๆงๅถไธ API ่ง่ๆๅ
โ โโโ HUB_DEPLOYMENT.md # ไธญๆข้จ็ฝฒไธ็ฝ็ปๆฅๅ
ฅๅ
จๆฏๆๅ
โ โโโ assets/ # ๆถๆๅพใๅฎๆบๆผ็คบไธๅทฅไฝๅบๆชๅพ
โโโ tests/ # ๅ
จ่ชๅจๅๆต่ฏๅฅไปถ (ๅทฅไฝๅบ/ๆ้/็ถๆๆบ/ๆๅ
)
โโโ version.json # ๅฎขๆท็ซฏ็ๆฌๅฎไน๏ผ่ชๅจๅๅธๆถๅๆญฅๆดๆฐ๏ผ
โโโ Dockerfile # ๆ็ฎ Alpine Node ็ไบง้ๅๅฎไน
โโโ docker-compose.yml # ไธ้ฎๅฎนๅจๅๆๅก็ผๆ
โโโ README.md
node --test tests/test_boost_fixes.mjs
node --test tests/test_rooms_and_auth.mjs
node --test tests/test_workspace.mjs tests/test_workspace_bridge.mjs tests/test_workspace_http.mjs
# ้ช่ฏ๏ผๅ
จ่ฆ็ๆต่ฏๅ้กบๅฉ้่ฟ๏ผๆถต็ๆไปถ็ถๆๆบใๆฟ้ด้ดๆใๅทฅไฝๅบๆ้ไธๅๅญๆไน
ๅ๏ผ- Q: ไปฅๅๅ่ฝๆดๆฐ้่ฆๅ
จๅ้ๆฐไธ่ฝฝๅฎ่ฃ
ๅ
ๅ๏ผ
ๆฅๅธธๆดๆฐๅฎๅ จไธ้่ฆใTeamCodex ้็จๅ่ฝจๆดๆฐๆบๅถ๏ผไพงๆ ๅไฝ็้ขไธๆณจๅ ฅ้ป่พไผๅจ่ฟๆฅๅข้้ไธญไธญๆขๆถ่ชๅจ็ญๅ ่ฝฝๆๆฐ่ๆฌ๏ผไป ๅจๆถๅๆไฝ็ณป็ปๅบๅฑ้ฉฑๅจๆๆ็ๆกๆถๅ็บงๆถ๏ผๆงๅถ้ขๆฟๆไผๆ็คบไธ่ฝฝๆฐ็ๅฎ่ฃ ๅ ใ - Q: ไธชไบบๅจๆฌๅฐๅๆบไฝฟ็จ๏ผ้่ฆ้ขๅคๆญๅปบๆๅกๅจๅ๏ผ
ไธ้่ฆใmacOS ๅฏๅจๆถไผ่ชๅจๅธธ้ฉป่ฝป้ไธญๆข๏ผWindows ่ๆๆบๅฎขๆท็ซฏ้่ฟ่ๆ็ฝ็ป่ชๅจๅ็ฐๅนถ่ฟๅ ฅ๏ผๅฎๅ จๅ ้ ็ฝฎใ - Q: ๆฐๆฎๅฎๅ
จไธ้็ง่พน็ๅฆไฝไฟ่ฏ๏ผ
็บฏๅฑๅ็ฝไธ็งๆ้จ็ฝฒใๆฐๆฎๅญๅจไบ่ชๅปบ็ฏๅข็data/messages.json๏ผๆ ไปปไฝๅค้จไบ็ซฏ้ฅๆตใ - Q: ้่ฟ Nginx ๅไปฃๅๆถๆฏๆ ๆณๅฎๆถๆจ้๏ผ
SSE ไพ่ตๆตๅผ้ฟ่ฟๆฅ๏ผNginx ๅฏนๅบlocationๅฟ ้กป้ ็ฝฎproxy_buffering off;ใ
While individual engineers code faster with Codex and ChatGPT, team engineering is sliding into a costly collaboration bottleneck:
- The "Document Tossing" Fallacy & Cascading Hallucinations
A developer prompts the AI, exports a lengthy, unverified markdown document or draft spec, and casually tosses it to a colleague. The recipient feeds this second-hand AI output into their own AI. Unchecked assumptions and fake methods in the original doc get compounded, resulting in severe hallucinations, broken contracts, and endless debugging friction. - Erasing Decision Rationale (The Missing "Why")
Static documents show only the final AI code snippet, completely erasing the vital problem-solving trajectory: "Which alternative architectures were ruled out? What boundary constraints were established? How was the prompt refined?" The next engineer inherits cold text without context, forced to guess the design intent. - Prompt Silos & Redundant Trial-and-Error
Engineer A spends hours steering the model through nuanced domain rules and subtle edge cases. When Engineer B picks up the next task, their local AI starts with zero memory, forcing them to reinvent prompts and repeat costly mistakes. - Manual Copy-Paste is Lossy and Leaky
Sharing screenshots or chat dumps over Slack/Discord flattens rich multi-turn reasoning chains while risking accidental exposure of local absolute filepaths, private tokens, and shell command histories.
The Solution: Live Context Snapshots over Second-Hand Static Docs:
TeamCodex turns AI conversation state into a first-class collaborative assetโjust like Git commits for source code.
- Native Embedding: Injected into official Codex / ChatGPT desktop sidebars via CDP without modifying native executables;
- One-Click Sanitized Snapshots: Instantly package active conversation threads with automatic scrubbing of local private paths;
- Sub-Second Context Relay: Peers click to import the full reasoning trajectory into their own active sessions, ensuring the entire team operates on a single, verified source of truth.
Each member maintains a strictly isolated local AI session boundary while mounting the Team workspace via CDP on the same device to connect to the common Hub. Members exchange explicitly shared snapshots and collaborative assets through the Hub; each person decides what to import into their own AI session.
Follow one collaboration flow: Member A selects a chat and shares โ Hub stores the snapshot and broadcasts updates to room peers โ Member B inspects the thread in Team Workspace โ Member B selectively imports it into their local AI session. Real-time broadcast never unconditionally pushes unverified conversations into any member's private AI session.
- Peer-to-Peer Two-Way Collaboration: Every member can both share and import; A and B are equal collaborators rather than fixed senders or receivers, never directly merging local private chat sessions;
- Strict Privacy Boundary: Unshared conversations remain strictly local on personal devices and are never synced or leaked just by joining a room;
- Collaboration Hub: Centralizes room authentication, member permissions, messages, snapshots, real-time presence, task boards, knowledge base, asset libraries, and calendars;
- Persistence & Plugin Entry: The Hub persists messages, snapshots, and uploaded files on its host machine; the optional Codex plugin (Skills / Hook) can query Hub summaries and inject them into active tasks;
- Local Companion Mounting: The companion app mounts the Team workspace via CDP; CDP operates solely on localhost, while cross-machine communication is handled seamlessly via HTTP API + SSE.
Editable vector diagram ยท Deployment guide
To regenerate both languages as SVG and 3200 ร 2240 PNG, run python3 scripts/generate_architecture_members.py (or python3 scripts/generate_architecture_diagram.py) with Chrome / Chromium installed. Set CHROME_BIN to override the browser path.
The screencast below demonstrates full-featured real-time collaboration between a macOS host and a Windows 11 peer (80-second comprehensive demonstration covering task boards, asset management, role-based access, and sub-second context relay with synchronized bilingual commentary; see docs/assets/teamcodex_demo.mp4 for the high-definition video):
- ๐ 1. Task Board & Workflow Transitions: Drag-and-drop workflow status (To-Do, In Progress, Done) with instant permission checks and millisecond-level status synchronization;
- ๐ 2. Asset Library & Multi-Format Ingestion: Instant drag-and-drop ingestion for code files, documentation, images, and folders, creating a unified asset pool;
- ๐ 3. One-Click Sanitized Share (macOS): Click "Share Conversation" in the Codex sidebar, select any active troubleshooting session, and broadcast a privacy-scrubbed snapshot;
- โก 4. Sub-Second Presence & Context Relay (Windows): The peer client automatically renders incoming thread cards with zero latency; engineers click "Import Selected Dialogues" to inject verified historical reasoning directly into new prompts, eradicating second-hand communication distortion.
Grab pre-built installers directly from GitHub Releases:
| Platform | Installer | Setup & Experience |
|---|---|---|
| macOS | TeamCodex-macOS.dmg |
Drag TeamCodex.app into /Applications. Status bar upgraded to Pure White Geometric Vector Cloud Template Icon with negative space relief and >_ terminal glyph, adapting automatically to Dark/Light modes; click to open frosted Mini Dashboard |
| Windows | TeamCodex-Setup.exe |
Runs setup wizard for ARM64/AMD64. Left-click opens native dark floating dashboard (auto-dismiss on blur/Esc); Right-click opens pristine context menu with instant clean exit; guarded by global single-instance Mutex |
| Portable Archives | TeamCodex-macOS.zip / TeamCodex-Windows-arm64-amd64.zip |
Standalone portable green packages; includes emergency cleanup tool ้ๅบTeamCodex.cmd |
| Codex Plugin | TeamCodex-Codex-Plugin.zip |
Official standard Codex plugin archive; empowers AI with spatial read/write tools, automated UserPromptSubmit hook, and preset prompts |
Note: TeamCodex runs as a lightweight tray companion. Click the menu bar or tray icon to open the Mini Dashboard:
- Live Diagnostics: Instantly inspect Codex attachment status (๐ข Injected / ๐ก Waiting / ๐ด Disconnected), active Hub, and room occupancy;
- One-Click Actions: Launch & attach Codex, copy Smart Token, switch Hub URL, and restart injection;
- In-Place Hot Sync & Updates: Automatically pulls fresh injection logic; notifies when a new native binary release is available.
The Hub service supports three standard operational models:
| Model | Host Location | Client Connection | Target Scenario |
|---|---|---|---|
| Single-Host (Default) | macOS background auto-spawn | Windows VM auto-detects host bridge IP | Solo developers with Mac + VM setups (Zero config) |
| Private LAN | Always-on PC / Mac / NAS in LAN | Enter host LAN IP or paste Smart Token | 5 ~ 30 developer teams on shared office Wi-Fi |
| Cloud VPS | Linux Cloud Server | Domain name via Nginx HTTPS proxy | Globally distributed remote teams |
curl -fsSL https://raw.githubusercontent.com/we1jia/TeamCodex/main/scripts/deploy-hub.sh | bashDetects environment automatically: prefers Docker Compose; falls back to Node.js with Systemd / PM2 process supervision and automated health verification.
Copy and paste this structured prompt directly to terminal AI assistants (Claude Code, Codex, Cursor, OpenClaw):
Deploy TeamCodex Hub on this server following production standards:
1. Verify system dependencies (Docker/Docker Compose or Node.js >= 18);
2. Clone https://github.com/we1jia/TeamCodex.git to /opt/TeamCodex (or git pull latest main);
3. Prefer docker compose up -d; if Docker is absent, configure systemd service with auto-start;
4. Open port 18765 listening on 0.0.0.0;
5. Validate via: curl http://127.0.0.1:18765/api/health;
6. If Nginx is detected, configure reverse proxy with proxy_buffering off explicitly set for SSE streaming;
7. Output endpoint URL and a ready-to-use Smart Token.
Full documentation and Nginx TLS templates available at: Hub Deployment & Networking Guide (docs/HUB_DEPLOYMENT.md).
- Full-Featured Team Workspace (Kanban / Knowledge / Assets / Calendar): Natively integrates agile task tracking, review approval flows, full-text searchable docs, SHA-256 deduplicated asset libraries, and work calendars, closing the loop between AI reasoning and engineering lifecycle.
- Native Embedding & Tray Companion: Injects via CDP into Codex sidebars paired with a native macOS menubar / Windows tray Mini Dashboard that never intrudes on your main workspace.
- In-Place Hot Updates: Automatically synchronizes and caches updated sidebar injection scripts from centralized Hubs without forcing users to re-download binaries.
- State Machine Mutual Exclusion: Enforces single-selection highlighting during active collaboration, restoring native thread selections upon exit.
- Cross-Platform Presence: Cleanly isolates
MacvsWinnode identities with deduplicated active presence counters and heartbeat tracking. - Sanitized Snapshot Relay: Serializes conversation threads into privacy-safe snapshots, enabling peers to import context with a single click.
- Smart Token Protocol: Resolves connection strings formatted as
Hub: <URL> | Room: <Name> | Key: <Password>instantly with quick clipboard actions.
In addition to the visual sidebar tab and tray companion designed for human engineers, TeamCodex seamlessly integrates with the official Codex Plugin Architecture (comprising .codex-plugin/plugin.json, semantic skills/, and lifecycle hooks/).
- Sidebar
TeamTab (Human Dashboard): Designed for engineers. Provides immersive fullscreen room chat, real-time presence avatars, multi-room switching, snapshot timeline, and one-click thread imports; Team CodexPlugin (AI Hands & Ears): Designed for the active AI Assistant inside your session. Equips Codex with tool permissions to read/write the team hub, extract discussion summaries, and relay context autonomously via natural language.
Execute directly or click prompt pills in the Codex composer:
ๆๅผ Team Codex ๅข้ๅไฝ็ฉบ้ดใ (Open Team Codex Workspace)
๐ Wakes local daemon and guides user to focus the fullscreen team sidebar;่ฏปๅๅฝๅๅข้็ฉบ้ด็่ฎจ่ฎบๆ่ฆใ (Fetch Team Discussion Summary)
๐ Queries the active room compact summary and injects peer consensus and architecture decisions into the current task;ๆฅ็ๅฝๅๅข้็ฉบ้ด็ไปปๅก็ๆฟๅๆๅ่ฟๅบฆใ (View Task Board and Member Progress)๐ Reads task states, owners, reviewers, blockers, and work-calendar signals from the authorized workspace;ๆ็ดขๅฝๅๅข้็ฉบ้ด็็ฅ่ฏๅบๅ็ด ๆๅบใ (Search Knowledge Base and Assets)๐ Searches only resources visible to the current workspace identity and preserves resource revisions;ๆ้ๅฎ็ไปปๅกๅ่ตๆๅผ็จๅฐๅฝๅ Codex ๅฏน่ฏใ (Cite Selected Tasks and Resources)๐ Creates traceable context with source IDs and versions, placing it into the Team composer without auto-sending;ๆๅฝๅ Codex ๅฏน่ฏๅไบซๅฐๅข้็ฉบ้ดใ (Share Conversation to Team Room)
๐ Packages the current multi-turn reasoning chain, scrubs private local paths, and broadcasts a sanitized snapshot.
- Pre-flight Silent Probe: Before every prompt is dispatched to Codex, the hook issues a lightweight 1200ms request to
http://127.0.0.1:18765/api/compact.txt; - Sub-Second Context Injection: Dynamically appends the team latest decisions as
additionalContext, ensuring the AI solutions are grounded in single-source team truth; - Zero-Blocking Resilience: If the Hub is offline or timed out, the hook exits cleanly in 0ms without delaying standard chat.
- Explicit Workspace Queries: The hook never silently injects task-board, knowledge-base, or private asset data; those are read only when the user asks or selects a reference.
- Source CLI Installation:
codex plugin add /path/to/TeamCodex
- Offline Import: Download
TeamCodex-Codex-Plugin.zipfrom GitHub Releases and import via the Codex Plugins page.
Beyond real-time context relay, TeamCodex natively embeds a lightweight team workspace engineered for AI-native software delivery, closing the loop between exploratory prompts, architecture decisions, and task delivery.
- Four-Stage Workflow: Structured progression across ใBacklog (ๅพ ๅผๅง)ใ, ใIn Progress (่ฟ่กไธญ)ใ, ใPending Review (็ญๅพ ๅฎกๆ ธ)ใ, and ใCompleted (ๅทฒๅฎๆ)ใ;
- Comprehensive Task Metadata: Assign primary owners, multi-client collaborators (e.g., simultaneously
weijia(Mac)andweijia(Win)), and dedicated reviewers. Track start/due/review dates, priorities, blockers, acceptance criteria, and delivery notes with complete audit logs; - Strict Review & Approval Pipeline: Tasks submitted for review mandate a reviewer and delivery notes. Only designated reviewers can approve or return tasks with required feedback; task contents are locked during review to prevent tampering.
- Versatile Document Management: Supports Markdown writing, code snippets, and multi-format file uploads (up to 10MB, indexing up to 200,000 characters) with full-text search and category/tag filters;
- Fine-Grained Privacy & Sharing: Instant toggle between ใPrivate (ไป ๆๅฏ่ง)ใ and ใProject Shared (ๅฝๅ้กน็ฎๅ ฑไบซ)ใ. Private items are strictly guarded and never broadcasted to peers or shared snapshots;
- SHA-256 Content Addressing: Shared storage engine automatically deduplicates identical payloads, offering safe in-place image previews and raw file downloads.
- Cross-Timezone Scheduling: Automatically visualizes execution and review schedules tailored to each member's configured timezone, workdays, and unavailable dates;
- Intelligent Schedule Warnings: Flags non-working day conflicts, overdue milestones, and unscheduled task backlogs to safeguard delivery timelines.
- Structured Citations: Select any task or shared asset to generate formatted context blocks with source IDs, version numbers, and snapshot timestamps;
- Human-in-the-Loop Safeguard: Inserts context directly into the composer for review and editingโnever automatically dispatches or executes prompts without explicit user confirmation.
TeamCodex/
โโโ .codex-plugin/ # Official Codex plugin manifest (plugin.json)
โโโ hooks/ # Lifecycle hook for prompt-time context injection (UserPromptSubmit)
โโโ skills/ # Semantic skill instructions (skills/team-codex/SKILL.md)
โโโ assets/ # Plugin and application icons, logos & illustrations
โโโ inject/ # Client CDP injection, Web Components & UI logic
โ โโโ sidebar_fullscreen.js # Sidebar mount, snapshot scrub, and UI state machine
โ โโโ workspace.js # Workspace components (Kanban/Knowledge/Assets/Calendar) & state
โ โโโ workspace.css # Native-adaptive themes & compact responsive styling
โ โโโ attach_codex.mjs # Dynamic script sync, CDP attachment, and heartbeat loop
โโโ server/ # Zero-dependency Node.js services
โ โโโ dev_host.mjs # SSE Collab Hub (Port 18765: presence, multi-room, auth)
โ โโโ workspace_store.mjs # Workspace atomic disk write & JSON persistence
โ โโโ workspace_routes.mjs # Workspace RESTful API endpoints & permission guards
โ โโโ workspace_validation.mjs # Data validation, length limits & security guards
โ โโโ launcher_host.mjs # Local control plane service (Port 18767: status, updates)
โโโ ui/ # Frontend UI assets
โ โโโ index.html # Fullscreen standalone collaboration canvas
โ โโโ workspace.html # Workspace standalone entrypoint
โ โโโ panel.html # Frosted Mini Dashboard floating card
โโโ macos/ # macOS status bar app & packaging
โ โโโ TeamCodex.swift # Native Swift status bar source (Cocoa + WebKit)
โ โโโ TeamCodex-Status.png # Pure white vector cloud template icon (Dark/Light adaptive)
โ โโโ launch.sh # Runtime health supervisor
โ โโโ build_dmg.py # Standalone DMG builder with swiftc automation
โโโ windows/ # Windows tray suite & NSIS installer
โ โโโ tray-teamcodex.ps1 # Native tray companion (Left-click popup + Right-click menu)
โ โโโ run-teamcodex.ps1 # Startup supervisor with single-instance mutex
โ โโโ ้ๅบTeamCodex.cmd # [Emergency tool] One-click kill & tray cache cleanup
โ โโโ installer.nsi # NSIS setup wizard configuration
โโโ scripts/ # Ops & automation deployment scripts (deploy-hub.sh)
โโโ docs/ # Architectural manuals & workspace design specs
โ โโโ WORKSPACE.md # Workspace data models, access controls & API guide
โ โโโ HUB_DEPLOYMENT.md # Hub deployment and network topology guide
โ โโโ assets/ # Architecture diagrams, screencasts & workspace screenshots
โโโ tests/ # Full test suite (workspace, permissions, state machines)
โโโ version.json # Client version manifest (v1.2.0)
โโโ Dockerfile # Lightweight Alpine production container definition
โโโ docker-compose.yml # Container orchestration configuration
โโโ README.md
node --test tests/test_boost_fixes.mjs
node --test tests/test_rooms_and_auth.mjs
node --test tests/test_workspace.mjs tests/test_workspace_bridge.mjs tests/test_workspace_http.mjs
# Verification: Full automated suite passed cleanly (injection, rooms, workspaces & storage)- Q: Do team members need to re-download binaries for regular updates?
No. TeamCodex uses dual-track updates: sidebar collaboration scripts update dynamically in-place when connected to a team Hub. Native installers are only required when underlying platform drivers change. - Q: Does a solo developer on one machine need to host a cloud server?
No. macOS auto-starts the hub in the background, and Windows VM guests auto-detect the bridge IP out of the box. - Q: Is conversation data transmitted to external third parties?
No. TeamCodex operates purely on self-hosted instances. Data is confined to your owndata/messages.json. - Q: Real-time updates do not reach clients when behind Nginx?
SSE streaming requires unbuffered connections. Ensureproxy_buffering off;is present in the Nginxlocationblock.