What is Alfred?
Alfred watches your inbox, processes raw inputs (meeting notes, conversations, documents), and produces structured Markdown records in an Obsidian vault. It maintains relationships between records using wikilinks, enforces schemas, and continuously improves vault quality through automated scans and knowledge extraction. Each Alfred instance runs on a dedicated server, accessible exclusively through your Tailscale mesh network. Everything — from dropping files into the inbox to managing Temporal workflows — is available through the REST API documented here.How it works
Drop content into the inbox
Upload meeting notes, conversations, or documents via the API or directly into the vault’s
inbox/ directory.Curator processes the input
The Curator worker watches the inbox, invokes an AI agent to parse the raw content, and creates structured vault records with proper frontmatter, types, and wikilinks.
Janitor maintains vault health
The Janitor periodically scans the vault for broken links, invalid frontmatter, orphaned records, and other structural issues — then fixes them automatically.
Four tools, one vault
| Tool | Purpose | Trigger |
|---|---|---|
| Curator | Processes raw inbox files into typed vault records | Watches inbox/ for new files |
| Janitor | Scans for and fixes structural issues (broken links, bad frontmatter) | Periodic sweeps |
| Distiller | Extracts assumptions, decisions, constraints from records | On-demand or scheduled |
| Surveyor | Embeds, clusters, labels, and discovers relationships | Pipeline execution |
What you can do with the API
Manage vault records
Create, read, edit, move, delete records. Search by glob or grep. Upload files to the inbox.
Control workers
Start, stop, restart the Curator, Janitor, and Distiller. Trigger scans and processing runs.
Orchestrate workflows
List, start, terminate, signal, and cancel Temporal workflows. Manage cron schedules.
Manage devices
Approve, reject, rotate, and revoke OpenClaw device access.
Administer the instance
Manage containers, environment config, Tailscale networking, backups, and system health.
Stream logs
Real-time SSE log streaming from any Docker Compose service.