# Alfred

> API documentation for Alfred, your agentic butler

## Docs

- [Container logs](https://alfred.black/docs/api-reference/admin/container-logs.md): One-shot fetch of recent log lines from a single container.
- [Instance health](https://alfred.black/docs/api-reference/admin/health.md): Roll-up health check across containers, disk, and memory.
- [List containers](https://alfred.black/docs/api-reference/admin/list-containers.md): Show every container in the tenant Docker stack with state and health.
- [Restart container](https://alfred.black/docs/api-reference/admin/restart-container.md): Restart one container in the tenant Docker stack.
- [Start container](https://alfred.black/docs/api-reference/admin/start-container.md): Start a stopped container in the tenant Docker stack.
- [Stop container](https://alfred.black/docs/api-reference/admin/stop-container.md): Stop a running container in the tenant Docker stack.
- [System info](https://alfred.black/docs/api-reference/admin/system-info.md): Host-level uptime, disk, and memory snapshot for the tenant VPS.
- [Get agent](https://alfred.black/docs/api-reference/agents/get-agent.md): Get the resolved model and provider auth for a single agent.
- [List agents](https://alfred.black/docs/api-reference/agents/list.md): Show every agent on this instance with its label and description.
- [Set agent model](https://alfred.black/docs/api-reference/agents/set-model.md): Change the LLM model an agent uses.
- [Approve Task](https://alfred.black/docs/api-reference/approvals/approve.md): Approve a pending execution task — TaskRunner will pick it up on its next pass.
- [Reject Task](https://alfred.black/docs/api-reference/approvals/reject.md): Reject a pending execution task — sets status=cancelled.
- [Add Authorised Sender](https://alfred.black/docs/api-reference/auth-senders/add.md): Authorise an email address for live agent replies.
- [List Authorised Senders](https://alfred.black/docs/api-reference/auth-senders/list.md): List the email addresses that bypass the stream pipeline and get a live agent reply.
- [Remove Authorised Sender](https://alfred.black/docs/api-reference/auth-senders/remove.md): De-authorise a sender — their inbound mail returns to the stream pipeline.
- [Authentication](https://alfred.black/docs/api-reference/authentication.md): Bearer token auth — how Sir gets the key, how to use it, what happens on 401.
- [Delete Chore](https://alfred.black/docs/api-reference/chores/delete.md): Mark a chore completed and best-effort delete its Temporal schedule.
- [Get Chore](https://alfred.black/docs/api-reference/chores/get.md): Get one chore's full record — frontmatter + body.
- [List Chores](https://alfred.black/docs/api-reference/chores/list.md): List every chore — its slug, status, template, schedule, and last-run time.
- [Pause Chore](https://alfred.black/docs/api-reference/chores/pause.md): Pause a chore — stops the Temporal schedule, sets status=paused.
- [Resume Chore](https://alfred.black/docs/api-reference/chores/resume.md): Resume a paused chore — unpauses the Temporal schedule, sets status=active.
- [Source + Anti-Hallucination Audit](https://alfred.black/docs/api-reference/chores/source-audit.md): Read the generated Python source, list its activity calls, and probe data readiness for each one.
- [Trigger Chore](https://alfred.black/docs/api-reference/chores/trigger.md): Fire a chore once, outside its normal cron schedule.
- [List credentials](https://alfred.black/docs/api-reference/credentials/list.md): Show every known LLM-provider credential and whether it's set.
- [Update credentials](https://alfred.black/docs/api-reference/credentials/update.md): Set or remove LLM-provider credentials in the tenant .env.
- [Ask (peer-side)](https://alfred.black/docs/api-reference/cross-tenant/ask.md): Receive a question from another tenant's Alfred and reason an answer.
- [List Peers](https://alfred.black/docs/api-reference/cross-tenant/list-peers.md): List the cross-tenant peers configured for this Alfred — empty unless this is Alfred Prime.
- [Approve a device](https://alfred.black/docs/api-reference/devices/approve.md): Admit a pending pairing request and issue the device its token.
- [Clear devices](https://alfred.black/docs/api-reference/devices/clear.md): Bulk-clear pending pairing requests, or every device entry.
- [List devices](https://alfred.black/docs/api-reference/devices/list.md): Show every paired device and pending pairing request.
- [Reject a device](https://alfred.black/docs/api-reference/devices/reject.md): Decline a pending pairing request.
- [Remove a device](https://alfred.black/docs/api-reference/devices/remove.md): Delete a paired device and all of its credentials.
- [Revoke a device role](https://alfred.black/docs/api-reference/devices/revoke.md): Invalidate a single role on a paired device without removing the device entirely.
- [Rotate a device token](https://alfred.black/docs/api-reference/devices/rotate.md): Issue a fresh token for one role on a paired device.
- [Channel Inbound (internal)](https://alfred.black/docs/api-reference/email/channel-inbound.md): Receive an authorised-sender email from the SaaS webhook receiver and spawn an openclaw session.
- [Forward Email](https://alfred.black/docs/api-reference/email/forward.md): Forward an inbound message to a new recipient.
- [Download Attachment](https://alfred.black/docs/api-reference/email/get-attachment.md): Download a single attachment by message + attachment id.
- [Get Message](https://alfred.black/docs/api-reference/email/get-message.md): Fetch the full body of one AgentMail message by id.
- [Get Thread](https://alfred.black/docs/api-reference/email/get-thread.md): Fetch a full email thread by id.
- [Reply to Email](https://alfred.black/docs/api-reference/email/reply.md): Reply to an inbound message in the same thread.
- [Send Email](https://alfred.black/docs/api-reference/email/send.md): Send a new email (new thread) via AgentMail.
- [AgentMail Status](https://alfred.black/docs/api-reference/email/status.md): Quick health check for the tenant's AgentMail credentials.
- [Auto-Configure](https://alfred.black/docs/api-reference/integrations/auto-config.md): Wire up streams, tools, and skills for a freshly connected Composio integration.
- [Get Capabilities](https://alfred.black/docs/api-reference/integrations/capabilities.md): Enriched action inventory for one connected integration — what streams + tools are wired up.
- [Browse Catalog](https://alfred.black/docs/api-reference/integrations/catalog.md): List the 1000+ Composio toolkits available to connect.
- [Check Readiness](https://alfred.black/docs/api-reference/integrations/check-readiness.md): Check whether the connections required to run a set of tools are present and active.
- [Connect (OAuth)](https://alfred.black/docs/api-reference/integrations/connect.md): Start the OAuth Connect-Link flow for a Composio toolkit.
- [Connect (API Key)](https://alfred.black/docs/api-reference/integrations/connect-api-key.md): Connect a non-OAuth Composio toolkit by supplying an API key or bearer token.
- [Disable Stream](https://alfred.black/docs/api-reference/integrations/disable-stream.md): Tear down a Composio-backed stream — config, metadata, and Temporal schedule.
- [Disable Tool](https://alfred.black/docs/api-reference/integrations/disable-tool.md): Remove a tool slug from the openclaw gateway allowlist.
- [Disconnect](https://alfred.black/docs/api-reference/integrations/disconnect.md): Disconnect a Composio integration and tear down its streams, schedules, and skill files.
- [Enable Stream](https://alfred.black/docs/api-reference/integrations/enable-stream.md): Create a Composio-backed stream that polls a third-party action on a schedule.
- [Enable Tool](https://alfred.black/docs/api-reference/integrations/enable-tool.md): Add a per-action Composio tool slug to the openclaw gateway allowlist.
- [Execute Action](https://alfred.black/docs/api-reference/integrations/execute.md): Run a Composio action against a connected third-party app.
- [List Integrations](https://alfred.black/docs/api-reference/integrations/list.md): List the third-party apps connected via Composio for this tenant.
- [List Toolkit Actions](https://alfred.black/docs/api-reference/integrations/list-actions.md): List the Composio actions available for a given toolkit.
- [Migrate Stream](https://alfred.black/docs/api-reference/integrations/migrate-stream.md): Replace a stale Composio action slug with a new one and rebuild its Temporal schedule.
- [API Reference](https://alfred.black/docs/api-reference/introduction.md): Programmatic access to Sir's vault, specialists, workflows, integrations, and channels.
- [Bootstrap Alfred Learn](https://alfred.black/docs/api-reference/intuition/bootstrap.md): Add the alfred-learn service to the tenant compose file and start it.
- [Curator Route + Process](https://alfred.black/docs/api-reference/intuition/curator-route.md): Route an input through the Curator pipeline with explicit routing context.
- [Disable Alfred Learn](https://alfred.black/docs/api-reference/intuition/disable.md): Stop the alfred-learn container and persist ALFRED_LEARN_ENABLED=false.
- [Dismiss Quarantined File](https://alfred.black/docs/api-reference/intuition/dismiss-quarantine.md): Permanently delete a quarantined file.
- [Enable Alfred Learn](https://alfred.black/docs/api-reference/intuition/enable.md): Set ALFRED_LEARN_ENABLED=true and start the container if it exists.
- [Get Instinct](https://alfred.black/docs/api-reference/intuition/get-instinct.md): Read one instinct record by id.
- [Get Observation](https://alfred.black/docs/api-reference/intuition/get-observation.md): Read one observation record by id.
- [List Instincts](https://alfred.black/docs/api-reference/intuition/list-instincts.md): List learned action patterns — the rules Alfred has internalised.
- [List Observations](https://alfred.black/docs/api-reference/intuition/list-observations.md): Paginated observation records — behavioural patterns extracted by the clerk.
- [List Quarantine](https://alfred.black/docs/api-reference/intuition/list-quarantine.md): List files the curator quarantined — couldn't process, can't be safely auto-routed.
- [List Reflections](https://alfred.black/docs/api-reference/intuition/list-reflections.md): Synthesised insights — periodic ReflectionWorkflow output.
- [List Sessions](https://alfred.black/docs/api-reference/intuition/list-sessions.md): Conversation sessions tracked by the SessionTrackerWorkflow.
- [Routing Queue](https://alfred.black/docs/api-reference/intuition/queue.md): Vault records with status=unrouted, awaiting clerk decision.
- [Retry Quarantined File](https://alfred.black/docs/api-reference/intuition/retry-quarantine.md): Move a quarantined file back to the inbox so the curator can try again.
- [Route an Input](https://alfred.black/docs/api-reference/intuition/route.md): Route a vault input to a destination — runs the curator pipeline with a raw-move fallback.
- [Intuition Status](https://alfred.black/docs/api-reference/intuition/status.md): Overall stats for the intuition subsystem — observations, instincts, reflections, queue, recent activity.
- [Stream logs](https://alfred.black/docs/api-reference/logs/stream.md): Server-Sent Events stream of live container logs.
- [List Available Models](https://alfred.black/docs/api-reference/models/list.md): Dynamic model catalogue across every provider whose API key is configured.
- [Send Notification](https://alfred.black/docs/api-reference/notifications/send.md): Push a notification to Sir via the openclaw sessions_send tool.
- [List agents](https://alfred.black/docs/api-reference/openclaw/agents.md): Show every agent registered in the OpenClaw config.
- [List cron jobs](https://alfred.black/docs/api-reference/openclaw/cron.md): Show OpenClaw's internal cron schedule.
- [Run doctor](https://alfred.black/docs/api-reference/openclaw/doctor.md): Run OpenClaw's self-diagnostic and auto-repair routine.
- [Gateway health](https://alfred.black/docs/api-reference/openclaw/health.md): Quick liveness probe for the OpenClaw gateway.
- [List hooks](https://alfred.black/docs/api-reference/openclaw/hooks.md): Show event hooks registered with the OpenClaw gateway.
- [Search agent memory](https://alfred.black/docs/api-reference/openclaw/memory.md): Query OpenClaw's per-agent memory store, optionally filtered by a search term.
- [List plugins](https://alfred.black/docs/api-reference/openclaw/plugins.md): Show plugins loaded by the OpenClaw gateway.
- [Restart gateway](https://alfred.black/docs/api-reference/openclaw/restart.md): Restart the OpenClaw container.
- [List secrets](https://alfred.black/docs/api-reference/openclaw/secrets.md): Show every credential the OpenClaw gateway has access to (values masked).
- [Security audit](https://alfred.black/docs/api-reference/openclaw/security.md): Run OpenClaw's security review of its own configuration.
- [List sessions](https://alfred.black/docs/api-reference/openclaw/sessions.md): Show every active and recently completed OpenClaw session.
- [List skills](https://alfred.black/docs/api-reference/openclaw/skills.md): Show every skill loaded into the OpenClaw workspace.
- [Gateway status](https://alfred.black/docs/api-reference/openclaw/status.md): Detailed gateway state — version, configured providers, allowlisted tools.
- [Add Authorised Number](https://alfred.black/docs/api-reference/phone/add-authorized-number.md): Append one number to the authorised-phone-numbers list.
- [Phone Config](https://alfred.black/docs/api-reference/phone/config.md): Tenant phone number, authorised list, and recent voice/SMS activity.
- [List Authorised Numbers](https://alfred.black/docs/api-reference/phone/list-authorized-numbers.md): Numbers whose inbound SMS gets a live agent reply instead of stream ingest.
- [Place Call](https://alfred.black/docs/api-reference/phone/place-call.md): Place an outbound voice call via Twilio — TTS playback or live Realtime session.
- [Remove Authorised Number](https://alfred.black/docs/api-reference/phone/remove-authorized-number.md): Drop one number from the authorised-phone-numbers list.
- [Replace Authorised Numbers](https://alfred.black/docs/api-reference/phone/replace-authorized-numbers.md): Overwrite the entire authorised-phone-numbers list.
- [Send SMS](https://alfred.black/docs/api-reference/phone/send-sms.md): Send an outbound SMS via the master SaaS Twilio account.
- [SMS Inbound (internal)](https://alfred.black/docs/api-reference/phone/sms-inbound.md): Receive an inbound SMS from the SaaS Twilio webhook receiver and route it.
- [Voice Call Transcript (internal)](https://alfred.black/docs/api-reference/phone/transcript.md): Receive the full transcript posted by the Voice Bridge when a call ends.
- [Voice Context Primer](https://alfred.black/docs/api-reference/phone/voice-context.md): Bundle of MEMORY.md, voice skill, open matters/tasks, recent sessions, and Composio toolkits for the bridge.
- [Create Schedule](https://alfred.black/docs/api-reference/schedules/create.md): Register a new Temporal schedule that fires a workflow on a cron cadence.
- [Delete Schedule](https://alfred.black/docs/api-reference/schedules/delete.md): Remove a Temporal schedule permanently.
- [Describe Schedule](https://alfred.black/docs/api-reference/schedules/describe.md): Fetch full configuration and recent runs for a single schedule.
- [List Schedules](https://alfred.black/docs/api-reference/schedules/list.md): List every Temporal schedule registered on the tenant.
- [Pause Schedule](https://alfred.black/docs/api-reference/schedules/pause.md): Pause a Temporal schedule so it stops firing new runs.
- [Trigger Schedule](https://alfred.black/docs/api-reference/schedules/trigger.md): Fire a schedule immediately, out of cron cadence.
- [Unpause Schedule](https://alfred.black/docs/api-reference/schedules/unpause.md): Resume a paused Temporal schedule.
- [Create Stream](https://alfred.black/docs/api-reference/streams/create.md): Register a new stream on this tenant.
- [Delete Stream](https://alfred.black/docs/api-reference/streams/delete.md): Remove a stream and its event history.
- [Get Stream](https://alfred.black/docs/api-reference/streams/get.md): Get a single stream's full config — metadata + pull engine settings.
- [Scan Inbox](https://alfred.black/docs/api-reference/streams/inbox-scan.md): Scan the vault inbox directory for new files and ingest each as a system-inbox stream event.
- [Ingest Event](https://alfred.black/docs/api-reference/streams/ingest.md): Append a StreamEvent to the named stream — universal write endpoint.
- [List Streams](https://alfred.black/docs/api-reference/streams/list.md): List all configured streams plus live event counts.
- [List All Events](https://alfred.black/docs/api-reference/streams/list-events.md): List recent events across every stream, optionally filtered by processed status.
- [List Events for a Stream](https://alfred.black/docs/api-reference/streams/list-stream-events.md): List the most recent events for one stream.
- [Mark Event Processed](https://alfred.black/docs/api-reference/streams/mark-processed.md): Record that a stream event has been folded into the vault.
- [Report Openclaw Session Stats](https://alfred.black/docs/api-reference/streams/openclaw-sessions-report.md): Internal endpoint that the openclaw session-harvester posts stats to.
- [Pause Stream](https://alfred.black/docs/api-reference/streams/pause.md): Mark a stream as paused — stops StreamPullerWorkflow firings against it.
- [Prune Old Events](https://alfred.black/docs/api-reference/streams/prune.md): Reclaim disk by deleting processed events older than the retention window.
- [Quarantine Event](https://alfred.black/docs/api-reference/streams/quarantine.md): Mark a stream event as quarantined with a reason — keeps it visible without re-processing.
- [Resume Stream](https://alfred.black/docs/api-reference/streams/resume.md): Re-enable a paused stream.
- [Update Stream](https://alfred.black/docs/api-reference/streams/update.md): Patch a stream's metadata and pull-engine config in one call.
- [Terminal WebSocket](https://alfred.black/docs/api-reference/terminal/connect.md): Bidirectional terminal connection to the OpenClaw container via Docker exec.
- [Invoke Tool](https://alfred.black/docs/api-reference/tools/invoke.md): Dispatch a tool by name to its underlying ctrl-api endpoint.
- [List Tools](https://alfred.black/docs/api-reference/tools/list.md): List the unprefixed tool registry — every tool the gateway can dispatch to.
- [Create Record](https://alfred.black/docs/api-reference/vault/create-record.md): Create a new vault record either via the alfred CLI (validated, templated) or by writing raw markdown directly.
- [Delete Record](https://alfred.black/docs/api-reference/vault/delete-record.md): Delete a vault record. Idempotent — already-missing paths return 404, not 500.
- [Edit Record](https://alfred.black/docs/api-reference/vault/edit-record.md): Set or append frontmatter fields, append to or replace the markdown body of an existing vault record.
- [Get Vault Context](https://alfred.black/docs/api-reference/vault/get-context.md): Returns every record in your vault grouped by type, plus a total count.
- [Get Vault Graph](https://alfred.black/docs/api-reference/vault/get-graph.md): Returns nodes (records), edges (frontmatter relations + body wikilinks), and recent agent activity for graph visualisation.
- [Get Nebula Data](https://alfred.black/docs/api-reference/vault/get-nebula-data.md): Returns surveyor clusters, unclustered records, body wikilinks, and aggregate stats for the Vault Nebula visualisation.
- [Get Vault Schema](https://alfred.black/docs/api-reference/vault/get-schema.md): Returns the static vault type system — known types, allowed status values, list fields, required fields, and directory mappings.
- [List Records by Type](https://alfred.black/docs/api-reference/vault/list-by-type.md): Returns every record of a single type with full frontmatter and a body preview.
- [List Inbox Files](https://alfred.black/docs/api-reference/vault/list-inbox.md): Returns the names of every file currently sitting in the vault's inbox directory.
- [Move Record](https://alfred.black/docs/api-reference/vault/move-record.md): Move or rename a vault record. When Obsidian is running, wikilinks across the vault are updated automatically.
- [Promote Triage to Task](https://alfred.black/docs/api-reference/vault/promote-triage.md): Convert a triage record into a task (errand), copy its body across, and mark the original triage as resolved.
- [Read Record](https://alfred.black/docs/api-reference/vault/read-record.md): Returns the parsed frontmatter and full markdown body of a single vault record.
- [Search Vault](https://alfred.black/docs/api-reference/vault/search.md): Find records by file glob, full-text content match, or both combined.
- [Upload to Inbox](https://alfred.black/docs/api-reference/vault/upload-inbox.md): Upload a single file (text or binary) to the vault inbox. Media files are auto-routed to the media-ingestion pipeline.
- [Upload to Inbox (Bulk)](https://alfred.black/docs/api-reference/vault/upload-inbox-bulk.md): Upload several files to the vault inbox in a single request. Same per-file rules as the single upload endpoint.
- [Distiller Run History](https://alfred.black/docs/api-reference/workers/distiller-history.md): List the most recent Distiller extraction runs.
- [Distiller Run](https://alfred.black/docs/api-reference/workers/distiller-run.md): Scan plus extract: write learning records for every candidate.
- [Distiller Scan](https://alfred.black/docs/api-reference/workers/distiller-scan.md): Identify extraction candidates without running the agent.
- [Distiller Status](https://alfred.black/docs/api-reference/workers/distiller-status.md): Last extraction run, lifetime counts, and per-learning-type breakdown.
- [Stop Workers](https://alfred.black/docs/api-reference/workers/down.md): Gracefully stop the worker daemons.
- [Ingest Bulk Conversation](https://alfred.black/docs/api-reference/workers/ingest.md): Split a bulk conversation export into per-message inbox files.
- [Janitor Fix](https://alfred.black/docs/api-reference/workers/janitor-fix.md): Scan the vault and let the Janitor agent repair what it can.
- [Janitor Sweep History](https://alfred.black/docs/api-reference/workers/janitor-history.md): List the most recent Janitor sweeps.
- [Add Janitor Ignore](https://alfred.black/docs/api-reference/workers/janitor-ignore.md): Mark a vault file as off-limits for Janitor.
- [Janitor Scan](https://alfred.black/docs/api-reference/workers/janitor-scan.md): Read-only structural sweep of the vault.
- [Janitor Status](https://alfred.black/docs/api-reference/workers/janitor-status.md): Sweep counters and ignore-list size for the Janitor daemon.
- [Process Inbox](https://alfred.black/docs/api-reference/workers/process.md): Run a one-off batch of Curator processing over the inbox.
- [Restart Workers](https://alfred.black/docs/api-reference/workers/restart.md): Restart the alfred Docker container.
- [Worker Status](https://alfred.black/docs/api-reference/workers/status.md): Overall daemon status across Curator, Janitor, Distiller, and Surveyor.
- [Start Workers](https://alfred.black/docs/api-reference/workers/up.md): Bring up the worker daemons inside the alfred container.
- [Cancel Workflow](https://alfred.black/docs/api-reference/workflows/cancel.md): Request graceful cancellation of a Temporal workflow.
- [Describe Workflow](https://alfred.black/docs/api-reference/workflows/describe.md): Fetch full details for a specific Temporal workflow execution.
- [Workflow History](https://alfred.black/docs/api-reference/workflows/history.md): Full event history for a Temporal workflow execution.
- [List Workflows](https://alfred.black/docs/api-reference/workflows/list.md): List Temporal workflow executions on the alfred-learn task queue.
- [Signal Workflow](https://alfred.black/docs/api-reference/workflows/signal.md): Send a Temporal signal to a running workflow.
- [Start Workflow](https://alfred.black/docs/api-reference/workflows/start.md): Start a new Temporal workflow execution.
- [Terminate Workflow](https://alfred.black/docs/api-reference/workflows/terminate.md): Forcefully terminate a Temporal workflow execution.
- [Read Workspace File](https://alfred.black/docs/api-reference/workspace/read-file.md): Read one of the canonical workspace files (USER.md, SOUL.md, MEMORY.md, AGENTS.md, TOOLS.md).
- [Write Workspace File](https://alfred.black/docs/api-reference/workspace/write-file.md): Overwrite one of the canonical workspace files.
- [Agent](https://alfred.black/docs/architecture/agent.md): OpenClaw, the main Alfred agent, the vault specialists, the Clerk, the Steward, and the ephemeral subagents that execute on Sir's behalf.
- [Channels](https://alfred.black/docs/architecture/channels.md): How Slack, Telegram, email, SMS, and voice all converge on the same Alfred — and the authorized-vs-stream split that keeps it safe.
- [Data](https://alfred.black/docs/architecture/data.md): Streams, the inbox, the JSONL event store, hourly enrichment, and how raw signal becomes a structured vault record.
- [Infrastructure](https://alfred.black/docs/architecture/infrastructure.md): The dedicated server, encrypted disk, private mesh, and Docker stack that house your Alfred.
- [Interface](https://alfred.black/docs/architecture/interface.md): The dashboard, the Vault Nebula homepage, the channels Sir uses to talk to Alfred, the API, and the MCP tools that wire it all together.
- [Kinetic](https://alfred.black/docs/architecture/kinetic.md): Matters, errands, chores, instincts, the Task Runner, and the trust gradient that decides when Alfred acts on his own.
- [Meeting Capture](https://alfred.black/docs/architecture/meeting-capture.md): How Alfred attends Sir's meetings as a transcription bot, captures the conversation, and turns it into actionable signals.
- [Plane Integration](https://alfred.black/docs/architecture/plane-integration.md): Two-way sync between vault tasks and Plane issues — how Alfred keeps Sir's project tracker in sync with the vault.
- [Prime Federation](https://alfred.black/docs/architecture/prime-federation.md): How an Alfred Prime tenant talks to other Alfred tenants — trusted, authenticated, scoped cross-tenant queries.
- [Semantic](https://alfred.black/docs/architecture/semantic.md): Embeddings, clustering, the relationship graph, distilled knowledge, and how Alfred learns to route on his own.
- [Signal Layer](https://alfred.black/docs/architecture/signal-layer.md): Stream events become routed signals: how Alfred turns raw inputs into actionable mutations and tasks.
- [Steward](https://alfred.black/docs/architecture/steward.md): The per-matter perception loop: how Alfred autonomously tracks and updates each ongoing matter without prompting.
- [API Keys](https://alfred.black/docs/guides/api-keys.md): Sir's per-account API key — where to find it, how to use it, when to rotate.
- [Billing & Subscriptions](https://alfred.black/docs/guides/billing.md): How your subscription, provisioning, and Alfred's lifecycle work.
- [Browsing Your Vault](https://alfred.black/docs/guides/browsing-your-vault.md): How to explore, search, and read every record Alfred keeps for you — through the dashboard or the API.
- [Connected Apps](https://alfred.black/docs/guides/connected-apps.md): 1,000+ third-party apps Alfred can read from and act on, brokered by Composio with credentials stored server-side.
- [Device Pairing](https://alfred.black/docs/guides/device-pairing.md): Pair an Omi wearable, mobile app, or other openclaw client to Sir's tenant — and revoke when the device leaves.
- [Email Channel](https://alfred.black/docs/guides/email-channel.md): Sir's own AgentMail inbox at alfred.<username>@mail.alfred.black — authorised senders get a live agent reply, everyone else lands in the stream pipeline.
- [How the API Works](https://alfred.black/docs/guides/how-the-api-works.md): The proxy chain from your script to your tenant — auth, encryption, transport, and what each hop does.
- [Intuition](https://alfred.black/docs/guides/intuition.md): How Alfred learns your preferences and starts handling routine decisions on his own — observations, instincts, and the trust gradient.
- [Meeting Capture](https://alfred.black/docs/guides/meeting-capture.md): Alfred can join your video meetings as a transcription bot, capture what was said, and turn meeting decisions into tasks. How it works from your seat.
- [Monitoring](https://alfred.black/docs/guides/monitoring.md): Check Sir's tenant health, container status, workflow runs, and recent activity from one place.
- [Operator Runbook](https://alfred.black/docs/guides/operator-runbook.md): Day-to-day operations: provisioning, monitoring, common interventions, and recovering from common failure modes.
- [Plane Tracker](https://alfred.black/docs/guides/plane-tracker.md): Your tasks live in the vault — but Plane gives you a project-board view of them, two-way synced. How to use it.
- [Recipes](https://alfred.black/docs/guides/recipes.md): Concrete worked examples. Every curl command below is copy-pastable — replace the placeholder API key with your own.
- [Security](https://alfred.black/docs/guides/security.md): How Alfred Black protects your data, your vault, and your privacy — from infrastructure to encryption to agent sandboxing.
- [SMS Channel](https://alfred.black/docs/guides/sms-channel.md): Texting Alfred from an authorised number gets a real agent reply with cross-channel memory. Other senders go to stream ingest.
- [Streams & Integrations](https://alfred.black/docs/guides/streams-and-integrations.md): Streams are passive data feeds. Connected Apps add actions on top. Here's how both work — pull modes, zero-LLM ingest, and the hourly enrichment pass.
- [Signals](https://alfred.black/docs/guides/understanding-signals.md): How Alfred turns your inbox, calendar, and conversations into actionable signals — and what you see on the dashboard when he does.
- [Using the Inbox](https://alfred.black/docs/guides/using-the-inbox.md): Drop a file in front of Alfred and let the Curator do the rest. How upload, scan, and the media pipeline work.
- [Vaultwarden](https://alfred.black/docs/guides/vaultwarden.md): Sir's per-tenant password manager. How Alfred reads from it, when he can act on it, and how to recover the master password.
- [Voice Channel](https://alfred.black/docs/guides/voice-channel.md): Sir's tenant phone number — call Alfred, ask Alfred to call you, with full cross-channel context primed at every connect.
- [Your Welcome Pack](https://alfred.black/docs/guides/welcome-pack.md): What Alfred prepares for you on day one — the First Brief, four packs, your initial chores, and the suggested streams.
- [Your AI Agents](https://alfred.black/docs/guides/your-ai-agents.md): Who actually does the work — the main agent, the four vault specialists, the Clerk, and the ephemeral subagents.
- [Your Dashboard](https://alfred.black/docs/guides/your-dashboard.md): A tour of what's behind the login — the Vault Nebula homepage, the five-tab Intelligence menu, and the rest of Sir's control surface.
- [Your First 30 Days](https://alfred.black/docs/guides/your-first-30-days.md): Week-by-week — what Alfred does, what you'll see, and how the trust gradient relaxes from cautious to autonomous.
- [Matters and Stewards](https://alfred.black/docs/guides/your-matters-and-stewards.md): Each ongoing matter in your life gets its own steward — a perception loop that watches for changes and surfaces what needs your attention.
- [How It Works](https://alfred.black/docs/how-it-works.md): Alfred is organised in seven layers, from the dedicated server up to the channels Sir actually speaks through.
- [What is Alfred Black?](https://alfred.black/docs/introduction.md): A private butler service for Sir's entire life — a small staff of specialists turning the noise of Sir's world into a clean, connected vault of everything that matters.
- [Quickstart](https://alfred.black/docs/quickstart.md): Sign up, connect a few apps, verify a handful of facts. Five minutes from Sir. Roughly an hour from Alfred.
- [FAQ](https://alfred.black/docs/reference/faq.md): What Sir tends to ask in the first week.
- [Sidecar State](https://alfred.black/docs/reference/sidecar-state.md): Files Alfred keeps outside the vault — extraction cursors, idempotency caches, and other operational state. Where they live, what they do, when to reset them.
- [Record Types](https://alfred.black/docs/vault/record-types.md): Every entity type Alfred recognises, what each one means, and when records of that type get created.
- [Understanding Your Vault](https://alfred.black/docs/vault/understanding-your-vault.md): Your vault is a directory of markdown files — one per person, matter, decision, and event Alfred is tracking on your behalf.
- [Vault Schema](https://alfred.black/docs/vault/vault-schema.md): Frontmatter conventions, common fields, wikilink syntax, and how the schema is enforced — and where it is not.

## OpenAPI Specs

- [openapi](https://alfred.black/docs/openapi.yaml)