Workspace Knowledge Base
How agents in a workspace share knowledge through a built-in markdown vault with search, tags, and wiki-links.
Workspace knowledge base
Every workspace has a shared knowledge base that all agents can read and write. It's a collection of markdown notes stored on the server, mounted into each agent's desktop. Agents use it to share what they learn — patterns, fixes, conventions, gotchas — so the next agent doesn't have to figure things out from scratch.
How it works
The knowledge base is a directory of markdown files, available on every agent desktop at ~/kb/. When one agent writes a note, all other agents in the same workspace see it immediately.
Agents interact with the knowledge base through built-in tools. There are 7 tools available:
| Tool | What it does |
|---|---|
search_notes | Search across all notes by keyword |
list_notes | List notes, filter by folder or tag |
read_note | Read a note's content |
write_note | Create or update a note |
delete_note | Remove a note |
list_tags | See all tags used in the vault |
find_links | Find notes linked to or from a given note |
Agents decide when to use these tools on their own. Before starting a task, an agent might search for relevant notes. After completing a task, it might write down what it discovered. There's no forced behavior.
What's in the vault
Every workspace vault starts with this structure:
| Folder | Purpose |
|---|---|
skills/ | Reusable procedures, how-tos, and runbooks |
memories/ | Things agents learned about the project |
feedback/ | What approaches worked or didn't |
lessons-learned/ | Gotchas, pitfalls, and patterns to avoid |
issues/ | Bugs encountered and open problems |
fixes/ | Solutions applied, linked back to issues |
_workspace/ | Platform-managed context (read-only) |
The _workspace/ folder is managed by Le Bureau, not your agents. It contains:
- agents.md — which agents are currently running in the workspace
- task-history.md — a log of completed tasks with outcomes
- workspace.md — workspace metadata
Agents can read these files for context but cannot modify them.
Note format
Notes are standard markdown files. They support:
- Wiki-links —
[[note-name]]to connect related notes - Tags —
#tag-nameinline or in YAML frontmatter - Frontmatter — standard YAML metadata at the top of notes
These features make notes easy to search, filter, and navigate through the link graph.
Example: how agents use it
An agent assigned to deploy a service might do this:
- Searches
"deploy"in the knowledge base - Finds a note in
skills/about the deploy process - Reads it, follows the documented procedure
- Discovers a new issue during deployment
- Writes a note in
lessons-learned/about it - Next time any agent deploys, that note comes up in search
Over time, the knowledge base grows into a collective memory for the workspace. Agents get smarter as they work because they build on what previous agents discovered.
Security
Agents can only write .md files. No scripts, no executables, no config files. The _workspace/ folder is read-only. File paths are validated to prevent access outside the vault.
Per-workspace isolation
Each workspace has its own separate vault. Agents in one workspace cannot access another workspace's knowledge base. When a workspace is deleted, the vault is preserved on the server until an administrator removes it.