How noblehacks/frenemy works
Frenemy connects Claude Code, Codex, Antigravity/Gemini, and Kimi so whichever app the user is using can request advice or delegate work. The README describes those capabilities; the available source excerpts do not show the main relay or provider MCP implementations, so their detailed call flow is left unasserted. Real-work isolation is implemented by the worker workspace. Snitch is a separate VS Code panel backed by shared job records and hooks. The graph preserves these branches while limiting source-backed edges to visible references and documented behavior.
Main entry points: fleet.mjs Job records · run-job.mjs Job runner · beat-lib.mjs Activity hooks · extension.js VS Code panel
Components 22
AI interfaces
- Claude Code
- Codex
- Gemini / agy
- Kimi Code
- Claude tools
tools/ask-claude-mcp.mjs - Codex tools
tools/ask-codex-mcp.mjs - Antigravity tools
tools/ask-agy-mcp.mjs - Kimi tools
tools/ask-kimi-mcp.mjs - Relay orchestration
tools/relay-core.mjs
Delegated work
- Worker workspace
tools/worker-workspace.mjs - Worker safeguards
tools/worker-guard.mjs - Image delivery
tools/agy-image-delivery.mjs
Snitch monitoring
- Job records
snitch/bin/fleet.mjs - Job runner
snitch/bin/run-job.mjs - Activity hooks
snitch/hooks/beat-lib.mjs - VS Code panel
snitch/extension/extension.js - Job view model
snitch/extension/lib/model.js - Job archiving
snitch/extension/lib/archive-jobs.js
Shared runtime
- Shared job locks
snitch/extension/lib/joblock.js - Process platform
tools/platform.mjs
Other components
- User
- AI driver
Connections 17
- User → AI driver: gives request
README.md - AI driver → Claude tools: uses tools
README.md - AI driver → Codex tools: uses tools
README.md - AI driver → Antigravity tools: uses tools
README.md - AI driver → Kimi tools: uses tools
README.md - AI driver → Relay orchestration: delegates work
- Relay orchestration → Worker workspace: prepares and applies
- Worker workspace → Worker safeguards: checks safeguards
- AI driver → Image delivery: requests image delivery
- Job runner → Job records: records job status
snitch/bin/run-job.mjs - Activity hooks → Job records: updates job activity
snitch/hooks/beat-lib.mjs - VS Code panel → Job view model: builds job view
snitch/extension/extension.js - VS Code panel → Job archiving: archives jobs
snitch/extension/extension.js - Job archiving → Shared job locks: locks job updates
snitch/extension/lib/archive-jobs.js - Job runner → Process platform: launches processes
snitch/bin/run-job.mjs - Job records → Process platform: uses platform helpers
snitch/bin/fleet.mjs - Activity hooks → Job records: reads job helpers
snitch/hooks/beat-lib.mjs