Give your agent access to local directories like Obsidian vaults, code repositories, or data folders on your machine.

Local Folder Sources

Local folder sources give TorlyAI access to directories on your computer. This is useful for working with code repositories, notes, documents, or any local data.

Use Cases

Code Repositories

Read and analyze your codebase

Obsidian Vaults

Search and reference your notes

Document Folders

Access PDFs, spreadsheets, and documents

Data Directories

Process CSV, JSON, and data files

Adding a Local Folder

Click Sources → Add Source
Select Local Folder
Browse to select the directory
Configure access permissions (read-only recommended)
Optionally add a guide.md for context

Permissions

By default, local folders are read-only. If you need write access, you can configure allowedWritePaths in the source's permissions file.

// ~/.torlyai/workspaces/{id}/sources/{slug}/permissions.json
{
  "allowedWritePaths": [
    "/path/to/folder/**"
  ]
}

Adding Context with guide.md

You can add a guide.md file to provide context about the folder's contents. This helps TorlyAI understand how to use the data.

// ~/.torlyai/workspaces/{id}/sources/{slug}/guide.md

# My Notes Vault

This is my Obsidian vault containing:
- Daily notes in /daily/
- Project notes in /projects/
- Reference material in /references/

## Conventions
- Files are named YYYY-MM-DD for daily notes
- Project folders contain a README.md with overview

Local Folders