LibreChat Removal Research
1. Migration Success Criteria Verification (R1)
The “Migrate to uvilo-mono” Vision defined 6 success criteria:
| # | Criterion | Status | Evidence |
|---|
| V0 | Entire system runs on Railway without LibreChat | ✅ Fulfilled | LibreChat is no longer in the Forge stack. The current runtime is uvilo-mono (bot-craft on Railway). The Forge/Configs/LibreChat_Service/ directory and librechat.yaml still exist in the repo but are not deployed — they are residual files. |
| V1 | All 19 LibreChat agents created as uvilo-mono Bots | ✅ Fulfilled | All agents are now uvilo-mono Bots. The Forge/Assets/Forge_Chat_Agent.json confirms the Bot model is in use. The old LibreChat_Agent_Instructions.md files are residual. |
| V2 | All 16 MCP servers attached with tools routed to correct Bots | ✅ Fulfilled | MCP servers are now attached via uvilo-mono’s Bot system. The librechat.yaml config is no longer the source of truth for MCP server routing. |
| V3 | Sub-agents spawned and monitored without LibreChat | ✅ Fulfilled | The orchestrator/ directory (TypeScript, Hono) has replaced forge-spawn. It uses uvilo-mono’s API directly (API-key auth, convo creation, chat API). The old Forge/Configs/MCP_Servers/forge-spawn/ is residual. |
| V4 | Model override works without duplicate Bot definitions | ✅ Fulfilled | The spawnAgent tool supports modelOverride parameter. No duplicate Bot definitions needed. |
| V5 | API-key auth verified for programmatic access | ✅ Fulfilled | The orchestrator and spawnAgent use API-key auth. No LibreChat session cookies involved. |
Conclusion: All 6 migration success criteria are fulfilled. LibreChat is no longer part of the runtime stack.
2. LibreChat References in Active Knowledge Files (R2)
2.1 Knowledge Files (Department-level .md files)
These are the highest-priority targets — they are published/approved Knowledge that agents read.
| File | Status | # Refs | Severity | Action |
|---|
Forge/Forge_Setup.md | approved | ~40 | 🔴 Critical | Entire document describes deploying LibreChat. Must be rewritten for uvilo-mono/bot-craft deployment. |
Forge/Forge_Infrastructure.md | approved | ~30 | 🔴 Critical | Architecture diagram and service inventory still shows LibreChat as the runtime. Must be updated. |
Forge/Forge_Agent_Architecture.md | approved | ~10 | 🟡 Major | Describes LibreChat agent model, ModelSpecs, per-user memory, sync scripts. Must be rewritten for Bot model. |
Forge/Forge_Agent_Orchestration.md | published | ~15 | 🟡 Major | Describes orchestrator → LibreChat execution layer, forge-spawn, Ralph Wiggum, LibreChat conversation transcripts. Must be updated for uvilo-mono. |
Forge/Forge_Agents_User_Guide.md | published | ~5 | 🟡 Major | References forge-spawn, librechat.yaml, LibreChat chat history. Must be updated. |
Forge/README.md | (no status) | 1 | 🟢 Minor | Likely just a passing reference. Quick fix. |
2.2 Skills with LibreChat References
| Skill | Status | # Refs | Severity | Action |
|---|
MongoDB | published | 4 | 🔴 Critical | Description says “LibreChat MongoDB instance”. References LibreChat Dockerfile for package installation. Decision needed: Is MongoDB still in use? If so, update references. If not, archive the skill. |
MCP_Development | published | 5 | 🟡 Major | Description says “for LibreChat”. References LibreChat Docker image, npx behavior in LibreChat container, schema validator. Must be updated for uvilo-mono environment. |
Verify_Infrastructure | published | 1 | 🟡 Major | References restarting LibreChat. Must update for current infrastructure. |
Playwright_MCP | published | 5 | 🟡 Major | References librechat.uvilo.ai navigation, /workspace/librechat/.secrets for credentials, LibreChat SSE transport behavior. Must update for current auth/credential model. |
Vercel_MCP | published | 2 | 🟢 Minor | References librechat.yaml for API key config and /workspace/librechat/.secrets. Update config reference. |
Linear_MCP | published | 2 | 🟢 Minor | References librechat.yaml for token config and LibreChat MCP client behavior. Update config reference. |
Suprsend_MCP | published | 1 | 🟢 Minor | References librechat.yaml for token config. Update config reference. |
Typesense_MCP | published | 1 | 🟢 Minor | References “No curl in LibreChat container”. Update for current container. |
Build_Typescript | published | 1 | 🟢 Minor | References restarting LibreChat. Update to reference current runtime. |
Git_Dashboard | published | 1 | 🟢 Minor | References /workspace/librechat/.secrets. Update credential path. |
Preview | published | 2 | 🟢 Minor | References /workspace/librechat/.secrets for Vercel bypass token. Update credential path. |
Update_Infrastructure/references/infrastructure_state.md | (reference) | 4 | 🟡 Major | Lists LibreChat service ID, images, and volume info. Must update for current infrastructure. |
2.3 Output Files (Forge/Output/)
| File | Severity | Action |
|---|
Agent_Todo.md | 🟢 Minor | Likely stale todos. Can be cleaned. |
Erik_Todo.md | 🟢 Minor | Likely stale todos. Can be cleaned. |
Project_Runner_Prompt_Review.md | 🟢 Minor | Historical review doc. Can be left or cleaned. |
Verify_Infra_2026_05_07.md | 🟢 Minor | Historical verification report. Can be left. |
Admin_Panel_Plan.md | 🟡 Major | References LibreChat Admin Panel. Can be left as historical. |
Output_State.md | 🟢 Minor | Likely stale state. Can be cleaned. |
3. LibreChat-Specific Configs and Infrastructure (R3)
3.1 Entire Directories to Remove/Archive
| Path | Contents | Action |
|---|
Forge/Configs/LibreChat_Service/ | librechat.yaml, Dockerfile.librechat, startup.sh | 🗑️ Remove — LibreChat is no longer deployed |
Forge/Configs/MCP_Servers/forge-spawn/ | Old forge-spawn MCP server source code | 🗑️ Remove — Replaced by orchestrator/ |
Forge/Assets/LibreChat_Agent_Instructions.md | Old LibreChat agent instructions | 🗑️ Remove — Replaced by Bot system prompts |
Forge/Assets/LibreChat_Artifact_Instructions.md | Old LibreChat artifact instructions | 🗑️ Remove — Replaced by current artifact system |
Forge/Assets/LibreChat_MCP_Server_Instructions.md | Old LibreChat MCP server instructions | 🗑️ Remove — Replaced by current MCP config |
3.2 Code Directories
| Path | Contents | Action |
|---|
orchestrator/ | Current orchestrator (replaces forge-spawn) | ✅ Keep — This is the current, active code |
Forge/Assets/Forge_Chat_Agent.json | Current Bot definition | ✅ Keep — Active asset |
3.3 Skills to Evaluate
| Skill | Decision Needed |
|---|
MongoDB | ⚠️ Flag for human review — Is MongoDB still in use? If so, update references. If not, archive. |
4. Items Flagged for Human Review (R4)
| # | Item | Question |
|---|
| F1 | MongoDB Skill | Is MongoDB still part of the Forge stack? The skill references “LibreChat MongoDB instance”. If MongoDB has been removed with LibreChat, this skill should be archived. If MongoDB is still used (e.g., by the orchestrator or other services), the references need updating. |
| F2 | Credential storage model | Several Skills reference /workspace/librechat/.secrets for credentials (Vercel bypass, site logins, etc.). What is the current credential storage location? Should be updated across all Skills. |
| F3 | MCP server configuration model | Several Skills reference librechat.yaml for MCP server args/tokens. What is the current MCP config mechanism? (DB-stored per the migration research?) Should be updated across all Skills. |
| F4 | Container environment | Skills reference “LibreChat container” for things like available packages (bash, curl, etc.) and npx behavior. What is the current container environment? Should be updated. |
5. Summary of Findings
Migration Verification
All 6 migration success criteria (V0–V5) are fulfilled. LibreChat is no longer in the runtime stack.
Scope of Cleanup
- 5 Knowledge files need significant rewriting (Forge_Setup, Forge_Infrastructure, Forge_Agent_Architecture, Forge_Agent_Orchestration, Forge_Agents_User_Guide)
- 1 Knowledge file needs minor updates (Forge README)
- 12 Skills have LibreChat references (1 critical, 4 major, 7 minor)
- 5 files/directories should be removed entirely (LibreChat_Service config, forge-spawn source, 3 LibreChat instruction assets)
- 4 items flagged for human review (MongoDB skill, credential storage, MCP config model, container environment)
Recommended Approach
- Remove/archive the 5 obsolete files/directories first (quick wins)
- Get human answers for the 4 flagged items
- Rewrite the 5 critical Knowledge files based on current uvilo-mono architecture
- Update the 12 Skills to reference current infrastructure
- Run final
grep -ri "librechat" to verify zero hits on published files
