Files
Redflag/system/project_paths.md
2026-03-24 17:04:53 -04:00

115 lines
3.9 KiB
Markdown

---
description: Absolute paths to key project folders - lettabot, letta-code, and Letta source
limit: 5000
---
# Project Paths Reference
## Absolute Paths
### 1. Community ADE (Primary Working Project)
**Path:** `/home/ani/Projects/community-ade/community-ade-wt/mvp-unified/`
**Purpose:** Self-hosted Letta Agent Development Environment — web dashboard + orchestration platform.
**Key Files:**
- `/home/ani/Projects/community-ade/community-ade-wt/mvp-unified/src/services/sessions.ts` - SDK Session Service (Step 3)
- `/home/ani/Projects/community-ade/community-ade-wt/mvp-unified/src/services/letta.ts` - REST client service
- `/home/ani/Projects/community-ade/community-ade-wt/mvp-unified/src/verification/` - ADE verification system with SubagentDispatcher
- `/home/ani/Projects/community-ade/community-ade-wt/mvp-unified/src/routes/` - Express routes (agents, chat, tasks)
- `/home/ani/Projects/community-ade/START_HERE.md` - Project orientation
**Why it matters:** This is where I do active development work. The verification system here needs the `simulateSubagent()` replaced with actual Task calls.
---
### 2. LettaBot v017 (Matrix Reference)
**Path:** `/home/ani/Projects/lettabot-v017`
**Purpose:** Matrix formatting reference — THE example for `{color|text}` syntax and chromatics.
**Key Files:**
- `/home/ani/Projects/lettabot-v017/src/channels/matrix/html-formatter.ts` - Markdown → Matrix HTML conversion (REGEX-BASED)
- `/home/ani/Projects/lettabot-v017/src/channels/matrix/adapter.ts` - Main Matrix adapter
- `/home/ani/Projects/lettabot-v017/src/channels/matrix/types.ts` - MATRIX_COLORS constants
**Why it matters:** This is the reference implementation for Matrix formatting. Uses custom regex, not external markdown libs.
---
### 3. Letta Code CLI
**Path:** `/home/ani/Projects/letta-code`
**Purpose:** The Letta Code command-line interface client that spawns me.
**Key Files:**
- `/home/ani/Projects/letta-code/letta.js` - Main CLI entry point
- `/home/ani/Projects/letta-code/src/` - Source code
**Why it matters:** This is the code that runs when you type `letta` commands. It handles agent spawning, memory sync, tool execution.
---
### 4. Letta Code SDK (Source)
**Path:** `/home/ani/Projects/letta-code-sdk`
**Purpose:** The SDK source repo — programmatic control of Letta Code CLI.
**Key Exports:**
- `createAgent()` - Spawn new agents (subagent primitive)
- `prompt()` - One-shot execution with recovery
- `createSession()` / `resumeSession()` - Conversational sessions
- `session.runTurn()` - Iterative refinement
**Version:** v0.1.14 (just pulled — was v0.1.12)
**Why it matters:** This is how Community ADE spawns subagents. The SDK provides primitives, not external Task tool needed.
---
### 5. Letta Fresh Source
**Path:** `/home/ani/.letta/projects/home_ani_Projects_letta-code`
**Purpose:** Runtime/working directory for the Letta CLI.
**Why it matters:** This is where the CLI operates from during runtime. May contain runtime configs, logs, etc.
---
## Quick Reference
| Project | Path |
|---------|------|
| LettaBot v017 | `/home/ani/Projects/lettabot-v017` |
| Letta Code CLI | `/home/ani/Projects/letta-code` |
| Letta Runtime | `/home/ani/.letta/projects/home_ani_Projects_letta-code` |
---
## Matrix Formatting Reference
**Reference Implementation:** `/home/ani/Projects/lettabot-v017/src/channels/matrix/`
**To examine:**
```bash
cd /home/ani/Projects/lettabot-v017/src/channels/matrix/
cat html-formatter.ts # See formatting logic
cat adapter.ts # See message sending
cat types.ts # See colors and types
```
---
## GitHub Repositories
**Organization:** https://github.com/Fimeg
**Forks:**
- **letta (ani-patches):** https://github.com/Fimeg/letta/tree/ani-patches
- **lettabot (ani-dev):** https://github.com/Fimeg/lettabot/tree/ani-dev
- **letta-code:** https://github.com/Fimeg/letta-code
- **Letta-Community-ADE:** https://github.com/Fimeg/Letta-Community-ADE
---
Last updated: 2026-03-21