Document absolute paths to lettabot-v017, letta-code, and Letta runtime directories

system/project_paths.md

@@ -0,0 +1,74 @@
+---
+description: Absolute paths to key project folders - lettabot, letta-code, and Letta source
+limit: 2000
+---
+# Project Paths Reference
+
+## Absolute Paths
+
+### 1. LettaBot v017 (Primary Project)
+**Path:** `/home/ani/Projects/lettabot-v017`
+
+**Purpose:** The actual LettaBot source code - this is THE reference implementation.
+
+**Key Subdirectories:**
+- `/home/ani/Projects/lettabot-v017/src/channels/matrix/` - Matrix channel implementation
+  - `adapter.ts` - Main Matrix adapter, message sending
+  - `html-formatter.ts` - Markdown → Matrix HTML conversion
+  - `types.ts` - Type definitions, color constants
+- `/home/ani/Projects/lettabot-v017/src/core/` - Core LettaBot logic
+
+**Why it matters:** This is the active codebase. The Matrix formatting in `html-formatter.ts` is the **reference implementation** to follow.
+
+---
+
+### 2. 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
+
+---
+
+### 3. 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
+```
+
+---
+
+Last updated: 2026-03-21