**This is an old revision of the document!**
Table of Contents
Kilo Code for VS Code (Insider)
Requirements:
- I want to have research agent (web) that is available for all project, sothat I can do structured web search on topics.
- The research agent should store it's research memory as text (.md) files in local project folder structure for to create growing context for the project. ## Custom Modes and Agents
Kilo discovers these files via glob patterns in multiple config directories:
Scope Mode file path pattern Agent file path pattern
Project-local .kilo/modes/.md .kilo/agents/.md
Global (XDG) ~/.config/kilo/modes/.md ~/.config/agents/modes/.md
Legacy global ~/.kilo/modes/.md or ~/.kilocode/modes/.md
Agent Memory
Folder and Manifest Best Practices
Put source documents, manifests, helper files, and output directories in the Manifest instead of pasting large content into the prompt.
Put longer task instructions in workspace files such as README.md, task.md, or AGENTS.md; keep agent instructions focused on behavior and boundaries.
Use stable document IDs and a machine-readable manifest file so generated memos can cite sources and reviewers can inspect the path back to evidence.
Let Memory() manage its own memory artifacts. By default, sandbox memory uses memories/ and sessions/ under the workspace.
Keep generated artifacts under outputs/ so the application can inspect, copy, validate, or archive them after the run.
Keep mount scopes narrow. If you mount a data room, mount only what the agent should read or write.
Treat secrets as runtime configuration injected by your application or sandbox provider, not as prompt text or committed manifest content.
Prefer a small synthetic File(…) or Dir(…) entry for a tutorial, then switch to LocalDir, GitRepo, or storage mounts for production-sized datasets .
This is a visual preview of the sandbox workspace structure
.
The next cell builds the actual Manifest entries manually.
WORKSPACE_TREE = """
/workspace/
README.md
manifest.csv
docs/
batch_1/
batch_2/
batch_3/
outputs/
memories/ # Generated by Memory()
sessions/ # Generated by Memory()
""".strip()
print(WORKSPACE_TREE)
Prepare a Small Evidence Workspace
memvid mcp for vscode
Install npm, uv on windows
Setup memvid mcp server
Running local mpx server may not work due to not available PATH for non admin user.
Install memvid-mcp-server locally
If you have Node.js installed but npx isn't in PATH, install the package globally or locally:
npm install -g memvid-mcp-server
Then update the kilo.json configuration to use the direct path:
{
"command": ["memvid-mcp-server"],
...
}
Example:
"$schema": "https://app.kilo.ai/config.json",
"mcp": {
"memvid": {
"type": "local",
"command": [
"npx",
"-y",
"memvid-mcp-server@latest"
],
"environment": {
"OPENAI_API_KEY": "sk-proj-qoGHEBwSHb41x8slxaziGjq1RSp5Sz3FT3BlbkFJYfp15vPobwEm0e-Ib0zdRhOTntpQsGf2qSY8kA3FR6T4np3tMlrc79yjyXLWtcpEd1BaE-IbkA",
"MEMVID_LOCAL_STORAGE": "0"
},
"$schema": "https://app.kilo.ai/config.json",
"mcp": {
"memvid": {
"type": "local",
"command": ["memvid-mcp-server"],
"environment": {
"OPENAI_API_KEY": "sk-proj-NEZJMF3Yljd-lfp15vPobwEm0e-Ib0zdRhOTntpQsGf2qSY8kA3FR6T4np3tMlrc79yjyXLWtcpEd1BaE-IbkA",
"MEMVID_LOCAL_STORAGE": "0"
},