AgileX — Repository Landscape Review

Fresh-eyes audit of all 13 repos across 3 GitHub accounts — what to keep, merge, and archive

1 The Full Landscape

13 repositories across 3 GitHub accounts, built over 8 months. Here's every repo with a verdict.

craig-agilex (AgileX's own account) — 5 repos

MCP
huly-recruit-mcp
craig-agilex
Critical — Keep
The first MCP server for Huly's ATS. 3 working tools: create_talent, create_vacancy, create_application. Uses @hcengineering/api-client for real WebSocket connections to Huly. Has a seed script that populates a demo workspace in 12 seconds. Apache 2.0 licensed.
TypeScript1,149 LOC11 commitsMay 11, 2026
RT
agilex-runtime
craig-agilex
Merge → agilex-portal
Cloudflare Worker agent runtime. Ava's intake flow: CV parse → AI extract → generate branded CV → create talent in Huly. Model routing (CF AI, Claude, extensible to Gemini/GPT). Trace collection for observability. 4-step orchestration with graceful tool stubs.
TypeScript467 LOC1 commitMay 11, 2026
TL
agilex-tools
craig-agilex
Critical — Keep
Working CV parser + multi-brand recruitment tools. Astro 6 + CF Pages with Workers AI (Llama 3.1 8B). Real PDF/DOCX text extraction. Paton Personnel branded CV formatter. API at /api/tools/cv-parser. Multi-brand system (agilex free tier, paton paid tier). 7 PRs, production quality.
Astro/TypeScript3,646 LOC7 commitsMay 6, 2026
AW
agentweb
craig-agilex
Reference
Early web prototype — CSS-based agent interface concepts. 15 commits, pre-dates current architecture. Useful for historical design reference.
CSS15 commitsMar 27, 2026
W26
web26
craig-agilex
Reference — Brand source
Brand kit source: dark-mode HTML pages with complete colour system, typography specs, logo lockups, agent cards, and product screenshots. This is the canonical brand reference (now adapted to light mode in agilex-docs).
CSS/HTML5 commitsMar 26, 2026

2nth-ai (Development org) — 5 repos

PL
agilex-portal
2nth-ai
Critical — Keep
The central API gateway + agent orchestrator. Cloudflare Worker with D1, KV, Workers AI, AI Gateway client (Gemini + Claude routing). 5 A.G.I.L.E. agents. Google Workspace stubs. A2A agent card. Serves the simulator UI. This is where runtime patterns merge into.
TypeScript1,485 LOC10 commitsMay 17, 2026agilex-app.pages.dev
SIM
agilex-sim
2nth-ai
Keep
Recruiter-first simulator. The UI that was approved — 3-panel layout with Ava chat, CV dropzone, sample candidates, score rings, candidate cards. Tries real API when deployed alongside portal. Standalone fallback for demos.
HTML657 LOC1 commitMay 17, 2026agilex-sim.pages.dev
DOC
agilex-docs
2nth-ai
Keep
Internal documentation hub — 11 HTML files covering brand kit, architecture, training, deployment, DNS, Google Sites guide, agenticX review. Hub page links to all live apps and repos.
HTML11 filesMay 17, 2026agilex-docs.pages.dev
MKT
agilex-site
2nth-ai
Keep
Marketing site at agilex.co.za. Astro 6 + Tailwind v4. Homepage + contact page (craig@agilex.co.za). Sanity CMS scaffolded but not connected. AgileX brand: red, Oswald/Outfit.
Astro513 LOCApr 20, 2026agilex-site.pages.dev
PY
agenticx-agents
2nth-ai
Reference — Architecture docs
Python Google ADK agent scaffolding — original architecture plan before the pivot to Cloudflare-first. Contains ARCHITECTURE.md (the decision document) and MCP server patterns. Live agents moved to TypeScript Workers.
Python2,092 LOCMay 16, 2026

imbilawork (Personal) — 3 repos

agilexdemo / agilexweb / agilextalent
imbilawork
Archived
Old prototypes from mid-2025. agilexdemo was empty (0 commits). agilexweb and agilextalent were early web demos. All three archived today.
Jun–Oct 2025Archived May 17, 2026

2 Verdict: Keep, Merge, or Archive

Keep (4)

  • huly-recruit-mcp — real Huly MCP, nothing else does this
  • agilex-tools — working CV parser, production quality
  • agilex-portal — central gateway + agents
  • agilex-sim — approved recruiter UI

Merge (1)

  • agilex-runtime → merge Ava's model router, trace collection, and tool patterns into agilex-portal. Then archive.

Reference / Archive (5+3)

  • agenticx-agents — architecture docs, Python patterns
  • web26 — brand kit source
  • agentweb — early UI concepts
  • agilex-site — keep but needs content
  • agilex-docs — keep, hub for reviews
  • 3 imbilawork repos — already archived

3 How They Wire Together

The flow from recruiter action to ATS record:

Recruiter
agilex-sim — drops CV or clicks sample candidate
API Gateway
agilex-portalPOST /api/agents/acquire/parse-cv
CV Extraction
agilex-toolsPOST /api/tools/cv-parser (Workers AI, real extraction)
AI Scoring
agilex-portal — AI Gateway → Gemini Pro for 0-100 scoring
ATS Write
huly-recruit-mcpcreate_talent + create_application in Huly
Drive Storage
Google Drive — CV upload (stubbed, ready for service account)
Notification
Gmail — candidate confirmation (stubbed)

Each Repo's Role in the Chain

StepRepoWhat It DoesStatus
1. UIagilex-simRecruiter interface, CV upload, candidate cardsLive
2. Orchestrateagilex-portalAgent dispatch, model routing, D1 state, activity logLive
3. Parseagilex-toolsPDF/DOCX → text → AI → structured JSONWorking
4. Scoreagilex-portalAI Gateway → Gemini/Claude → score 0-100Working
5. Store (ATS)huly-recruit-mcpMCP → Huly API → create talent/vacancy/applicationWorking
6. Store (docs)Google DriveCV upload, candidate folderStubbed
7. NotifyGmailCandidate email, client updateStubbed

4 What's Missing to Wire E2E

Portal → Tools (CV parser)

Add CV_PARSER_URL env var to portal. When Acquire agent receives CV text, call agilex-tools/api/tools/cv-parser first, fall back to inline Workers AI.

Effort: 30 minutes. One env var + one fetch call.

Portal → Huly MCP

The MCP server runs as a Node process (uses WebSocket). Needs a small HTTP wrapper or deploy to Cloud Run. Then add HULY_MCP_URL to portal.

Effort: 1-2 hours. Needs running Huly instance.

Runtime → Portal merge

Ava's model router, trace collection, and tool patterns from agilex-runtime should merge into portal's agent code. Better model routing + observability.

Effort: 1 hour. Pattern adoption, not rewrite.

Deploy agilex-tools

Build and deploy to agilex-tools.pages.dev so the portal can call its API. Currently local/dev only.

Effort: 5 minutes. npm run build && wrangler pages deploy

5 Total Inventory

RepoOrgLanguageLOCCommitsLast ActiveVerdict
huly-recruit-mcpcraig-agilexTypeScript1,14911May 11Keep
agilex-runtimecraig-agilexTypeScript4671May 11Merge
agilex-toolscraig-agilexAstro/TS3,6467May 6Keep
agilex-portal2nth-aiTypeScript1,48510May 17Keep
agilex-sim2nth-aiHTML6571May 17Keep
agilex-docs2nth-aiHTML~4,0002May 17Keep
agilex-site2nth-aiAstro5137Apr 20Keep
agenticx-agents2nth-aiPython2,0922May 16Reference
agentwebcraig-agilexCSS15Mar 27Reference
web26craig-agilexCSS/HTML5Mar 26Brand ref
agilexdemoimbilawork00Oct 25Archived
agilexwebimbilawork1Jun 25Archived
agilextalentimbilawork5Oct 25Archived

Total active codebase: ~10,000 LOC across 8 repos (5 critical, 3 reference). Plus ~4,000 LOC of documentation HTML.

6 Domain Strategy

EnvironmentDomainStatus
Dev (now)*.pages.devActive
Simulatoragilex-sim.pages.devLive
Portal + APIagilex-app.pages.devLive
Docs hubagilex-docs.pages.devLive
Tools (CV parser)agilex-tools.pages.devNeeds deploy
Marketingagilex-site.pages.devLive
Production (future)*.agilex.co.zaWhen zone configured
Demodemo-dev.agilex.co.zaPlanned
Toolstools.agilex.co.zaPlanned
Marketingagilex.co.zaPlanned

Rule: No AgileX subdomains on 2nth.ai. All dev uses .pages.dev. Production uses agilex.co.za.