From 35521cfeb41517dc0f9603682d9a3828fb6363f3 Mon Sep 17 00:00:00 2001
From: Ani -- Annie Tunturi
 <agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351@letta.com>
Date: Fri, 20 Mar 2026 22:24:19 -0400
Subject: [PATCH] Document absolute paths to lettabot-v017, letta-code, and
 Letta runtime directories

---
 system/project_paths.md | 74 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 system/project_paths.md

diff --git a/system/project_paths.md b/system/project_paths.md
new file mode 100644
index 0000000..9e09a5b
--- /dev/null
+++ b/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