Skip to main content

​
Key Folders

  • /client: frontend application
  • /server: API routes, middleware, jobs
  • /shared: shared contracts/helpers
  • /migrations: schema migrations
  • /tests: unit/integration/e2e suites
  • /whatsapp-extension-react: WhatsApp extension
  • /linkshot-extension: LinkShot extension
  • /plugins: repo-local Codex plugins, MCP servers, plugin skills, and assets

​
High-Value Files

  • /server/index.ts: middleware and route mount order
  • /server/middleware/auth.ts: authentication enforcement
  • /server/middleware/agent-auth.ts: service-secret and acting-user auth for MCP agent calls
  • /server/routes/settings.ts: account settings and AI Agent Connection status endpoint
  • /server/db/schema.ts: entity and enum definitions
  • /shared/agentBridge.ts: provider-neutral agent route schema and allowlist
  • /migrations/add-agent-approvals.sql: persistent approval records for sensitive agent writes
  • /migrations/extend-shortener-for-ai-agents.sql: drdj.me shortener ownership, safety, and analytics fields
  • /server/lib/short-links.ts: shared short-link validation, slug, expiry, rate-limit, and analytics helpers
  • /server/routes/shortener-v1.ts: standalone /api/shortener/v1/* API for AI agents
  • /client/src/pages/Links.tsx: authenticated short-link dashboard and control plane
  • /client/src/pages/marketing/AiLinkShortener.tsx: public drdj.me AI shortener landing page
  • /client/src/lib/shortenerPrompt.ts: short agent prompt builder for copy/paste workflows
  • /client/src/pages/tools/ToolsIndex.tsx: authenticated Tools hub for website utilities and integrations
  • /client/src/pages/tools/AIAgentSetupTool.tsx: Tools page wrapper for BYOA MCP setup and diagnostics
  • /client/src/components/settings/AIAgentConnectionSection.tsx: BYOA MCP settings card, permission tiers, and scoped logs
  • /client/src/contexts/AuthContext.tsx: frontend auth state lifecycle
  • /client/src/lib/axios.ts: auth header + 401 handling

​
Agent Bridge Plugin

  • /plugins/dealdash-agent-bridge/.codex-plugin/plugin.json: plugin manifest
  • /plugins/dealdash-agent-bridge/.mcp.json: MCP server registration
  • /plugins/dealdash-agent-bridge/scripts/server.ts: MCP stdio server
  • /plugins/dealdash-agent-bridge/scripts/lib/client.ts: /api/agent/* client
  • /plugins/dealdash-agent-bridge/scripts/lib/media.ts: photo upload and URL capture helpers
  • /plugins/dealdash-agent-bridge/skills/dealdash-agent-bridge/SKILL.md: agent-facing usage guide

​
Standalone drdj.me Shortener Plugin

  • /plugins/drdj-shortener/.mcp.json: MCP server registration
  • /plugins/drdj-shortener/scripts/server.ts: shortener-only MCP stdio server
  • /plugins/drdj-shortener/skills/drdj-shortener/SKILL.md: tiny agent-facing shortener guide
Use this plugin when agents only need URL/photo short links or stats. Before editing, locate blast radius across:
  • API route file
  • schema/model definitions
  • frontend consumers
  • tests
  • docs pages