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.11.5 for Apple Silicon M1–M4 or v3.11.5 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

Measurement only. No advertising.
This site uses one tool, Google Analytics, to count visits and see which pages and download buttons are used. It sets a cookie so one visit can be told from the next. Not used for advertising, not shared with anyone else. Nothing about your files or your vault is involved — Ambient runs on your machine, and this is only about this website. Change your choice any time from “Measurement choice” in the footer. Privacy page.