Skip to main content

​
Overview

Most data reaches Alfred automatically through Streams — integrations with Gmail, Notion, Omi, and other services that feed events into your vault continuously. You don’t need to copy-paste or upload anything for these sources. The flow is:
  1. Stream event arrives (e.g., a new Gmail thread, a Notion page update, an Omi recording)
  2. The Event Processor reads and classifies it
  3. The Curator creates structured vault records and links them together
  4. Records appear in your vault within seconds
During onboarding, a 100-day Gmail backfill runs automatically — populating your vault with recent email history so Alfred has meaningful context from day one. For sources that aren’t connected as streams, you can still share content manually through the inbox. This is useful for ad-hoc data like one-off meeting notes, pasted research, or documents from tools you haven’t integrated yet.

​
Automatic sources (Streams)

The following integrations feed events into your vault without any manual effort:
  • Gmail — emails, threads, and attachments (100-day backfill + continuous sync)
  • Notion — pages and database entries as they change
  • Omi — ambient recordings and transcriptions
  • OpenClaw sessions — chat sessions with Alfred’s agents are captured as stream events via the alfred-inbox hook
Connect and manage streams from the Streams page on your dashboard.

​
Manual sharing (ad-hoc data)

For content that doesn’t come through a stream, share it manually:

​
From the dashboard

  1. Go to your Alfred Black dashboard
  2. On the Home page, click Upload to Vault in the Quick Actions section
  3. Enter a title and paste your content
  4. Click Submit
The Curator begins attending to it immediately.

​
Via the API — single item

curl -X POST /api/v1/vault/inbox \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "meeting-2026-02-26.md",
    "content": "# Product Sync\n\nAttendees: Alice, Bob\n\nAlice presented the Q1 roadmap. Decision: prioritize mobile app over desktop.\nBob will handle the API migration by end of March."
  }'

​
Via the API — multiple items at once

Share several items in a single request: 
curl -X POST /api/v1/vault/inbox/bulk \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {"filename": "standup-monday.md", "content": "# Monday Standup\n\n..."},
      {"filename": "standup-tuesday.md", "content": "# Tuesday Standup\n\n..."},
      {"filename": "research-notes.md", "content": "# Competitor Analysis\n\n..."}
    ]
  }'

​
What to share

Alfred works best with rich, natural-language content:
  • Meeting notes — standups, planning sessions, 1:1s, retrospectives
  • Conversation exports — email threads, chat logs, discussion summaries
  • Research — competitor analysis, market research, technical investigations
  • Voice transcripts — transcribed calls, voice memos, interviews
  • Ideas and brainstorms — rough thoughts, feature proposals, strategy notes
  • Project updates — status reports, progress summaries, post-mortems
For best results, include names (people, companies, projects), dates, and specific details. The more context you provide, the richer the records Alfred creates for you.

​
What happens next

Once content reaches the inbox:
  1. The Curator picks it up within seconds
  2. It identifies entities: people, organizations, projects, tasks, decisions
  3. It creates structured records for each entity
  4. All records are cross-linked to each other
  5. The original input is marked as attended to

​
Seeing what Alfred prepared

After sharing content, you can see what Alfred created: From the dashboard: Browse your vault, filter by type, and see newly created records. Via the API: 
curl -s /api/v1/vault/list/person \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
Tips for best results

  • Include people’s full names — “Alice Smith” works better than just “Alice”
  • Mention project names explicitly — “the Platform v2 project” helps Alfred create proper links
  • Be specific about decisions — “Decision: use PostgreSQL” is clearer than “we talked about databases”
  • Include dates — helps Alfred create accurate timelines
  • Don’t worry about formatting — raw text, markdown, or bullet points all work

Browsing Your Vault

See what Alfred created from your content

API Reference: Inbox

Full inbox API documentation