Workspace
Your agent's file-based knowledge base — memory, personality, and daily journals
The workspace is a folder of markdown files that serve as the agent's persistent knowledge base. Unlike the SQLite database (structured key-value memory), workspace files are human-readable documents you can browse and edit directly.
Workspace Structure
~/.foxl/workspace/
SOUL.md # Agent personality and behavior rules
USER.md # Information about you
MEMORY.md # General knowledge and notes
AGENTS.md # Sub-agent configurations
TOOLS.md # Tool usage notes and preferences
HEARTBEAT.md # Heartbeat schedule configuration
BOOTSTRAP.md # Initial setup instructions
memory/
2026-03-15.md # Daily conversation summary
2026-03-16.md # Daily conversation summary
...Core Files
| File | Purpose |
|---|---|
| SOUL.md | Agent personality, behavior rules, and system prompt. The most important customization file. |
| USER.md | Information about you — the agent learns and updates this over time. |
| MEMORY.md | General knowledge, notes, and reference material. |
| AGENTS.md | Sub-agent configurations. | | TOOLS.md | Tool usage notes and preferences. | | HEARTBEAT.md | Heartbeat schedule configuration. | | BOOTSTRAP.md | Initial setup instructions for new workspaces. | | memory/YYYY-MM-DD.md | Auto-generated daily conversation summaries. |
For detailed descriptions of each file — including how to customize SOUL.md as your system prompt and what to put in USER.md — see the Memory guide.
Browsing the Workspace
From the Dashboard
Open the Workspace page in the sidebar to browse all files in a web-based editor. You can read and edit files directly.
From the Filesystem
Open any workspace file with your preferred text editor:
# macOS / Linux
code ~/.foxl/workspace/USER.md # VS Code
nano ~/.foxl/workspace/SOUL.md # Terminal
open ~/.foxl/workspace/ # Finder
# Windows (PowerShell)
code $env:USERPROFILE\.foxl\workspace\USER.md
explorer $env:USERPROFILE\.foxl\workspaceThrough Conversation
Ask the agent about its workspace:
- "What's in your SOUL.md?"
- "Show me my USER.md"
- "What did we discuss yesterday?" (reads daily journal)
Workspace Tools
The agent uses these tools to interact with the workspace:
| Tool | Description |
|---|---|
| workspace_memory_save | Add content to a workspace file |
| workspace_memory_read | Read a workspace file |
| workspace_memory_search | Search across all workspace files |
| workspace_memory_edit | Edit sections of a workspace file |
Privacy
All workspace files are local. They are never uploaded to Foxl servers or included in API calls to AI providers (unless the agent explicitly reads them into the conversation context).