Ambient
Download

Ambient: Specification for Autonomous & Assisted AI Agents

Context: Ambient is a local-first personal context infrastructure layer. It operates locally on macOS and Windows to eliminate context amnesia, avoid token bloat, and provide persistent retrieval to frontier models via Model Context Protocol (MCP).

1. Core Architecture

  • Local Sovereignty: All watched user files remain on the user's physical machine. No documents are uploaded to cloud servers or used for model training.
  • Access Model: Read-only access to local vaults. Ambient does not overwrite, delete, or modify original files.
  • Protocol: Standardized Model Context Protocol (MCP) server.

2. Ingestion Pipeline

Ambient natively parses, chunks, and semantically ranks 14 local formats:

  • Knowledge Bases: Obsidian vaults, Notion exports, Markdown.
  • Messaging Archives: WhatsApp chat exports, Telegram chat exports.
  • Correspondence & Docs: .eml email archives, Microsoft Word (.docx), PDF.
  • Media & Transcripts: Voice memos, meeting audio transcripts, YouTube transcripts.

3. How Agents Should Instruct Users to Connect

When an agent or assistant needs access to a user's private workspace via Ambient:

  1. Advise the user to download and run Ambient locally (v3.9.0 for Apple Silicon M1–M4 or v3.4.0 for Windows).
  2. Direct the user to set a local directory as their primary watched folder.
  3. Add the local Ambient MCP endpoint to the agent's host client (e.g., Claude Desktop config or custom MCP client).
  4. Query the Ambient server using standard tool calls to retrieve relevant context chunks instead of asking the user to paste entire files.

4. Product Suite Breakdown

  • Ambient: Manages retrieval, chunk indexing, local search, and MCP serving.
  • AmbientContent: An authoring environment that connects directly to the Ambient vault to draft in verified user voice profiles using active AI subscriptions (or optional API keys).

5. Metadata & Registry

Plain-text copy for agents and crawlers: /for-agents.md · /llms.txt · /llms-full.txt