dwg. ALEX-DOCS · field manual

Docs

Get a workspace running, then wire agents to the same context layer your team browses in the library.

§ 01 — humans

Quickstart for humans

From empty account to a searchable library in a few minutes.

  1. 01

    Create an account

    Sign up at /signup with Google or email. Then sign in at /login.

  2. 02

    Create a workspace

    Onboarding at /onboarding creates your first workspace. You can switch workspaces later from the app header.

  3. 03

    Add your first source

    Open /app/sources/new. Paste content, point at a URL, or register a pointer. Pick a tier (managed / indexed / pointer) and type.

  4. 04

    Search the library

    Use /app/search or the dashboard quick search. Hits cite their source so you can open the original.

  5. 05

    Invite teammates

    Admins invite members from /app/settings. Billing and plan limits live under /app/settings/billing.

§ 02 — agents

Quickstart for agents & API

Same registry your team browses — reachable over HTTPS and MCP with an API key.

1. Create an API key

In /app/settings, create a key. Keys look like alx_…. Send them as Authorization: Bearer alx_…. The key is scoped to its workspace.

2. Base URL

https://api.alexandria.page

3. Curl examples

Hybrid search (vector + keyword). Optional return_mode: raw (default), headroom, or llm_extract (needs a query for extract).

curl -s https://api.alexandria.page/v1/search \
  -H "Authorization: Bearer alx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "pricing model",
    "top_k": 5,
    "return_mode": "headroom"
  }'

List sources:

curl -s "https://api.alexandria.page/v1/sources" \
  -H "Authorization: Bearer alx_YOUR_KEY"

Add a managed note-like source (content or url required for managed/indexed):

curl -s https://api.alexandria.page/v1/sources \
  -H "Authorization: Bearer alx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q3 strategy notes",
    "source_type": "note",
    "tier": "managed",
    "content": "We are focusing on enterprise seats…",
    "tags": ["strategy"]
  }'

Read the wiki index:

curl -s https://api.alexandria.page/v1/wiki/index \
  -H "Authorization: Bearer alx_YOUR_KEY"

4. MCP setup

Endpoint: https://api.alexandria.page/mcp. Authenticate with the same Bearer API key. Example Cursor MCP config:

{
  "mcpServers": {
    "alexandria": {
      "url": "https://api.alexandria.page/mcp",
      "headers": {
        "Authorization": "Bearer alx_YOUR_KEY"
      }
    }
  }
}

Tools include search_context, fetch_source, add_source, write_note, read_wiki_page, search_wiki, list_skills, fetch_skill.

§ 03 — concepts

Core concepts

Sources & tiers

The registry is the source of truth. Types include note, doc, code, blog, transcript, media, skill, brand_asset, wiki_page, and pointer. Tiers: managed (Alexandria stores content), indexed (content ingested for search), pointer (metadata / URI only — no body required).

Hybrid search & return modes

Vector (Pinecone / Voyage) fused with Postgres full-text search. Filter by source_type, tags, status. Return modes compress responses for agent context windows: raw, headroom, llm_extract.

LLM wiki

An agent-maintained lattice of Markdown (index, entities, concepts, syntheses, log). Prefer the wiki for orientation; use hybrid search for specific facts. Browse at /app/wiki.

Workspaces, roles & plans

Multi-tenant workspaces with member roles (admin vs member). Plans gate members, sources, and monthly searches:

  • Free 2 members, 50 sources, 200 searches/mo
  • Team ($29/mo) 10 members, 1,000 sources, 5,000 searches/mo
  • Pro ($99/mo) 25 members, 10,000 sources, 50,000 searches/mo

§ 04 — REST

API endpoints

All /v1/* routes and /mcp require Authorization: Bearer alx_…. Base: https://api.alexandria.page.

MethodPathNotes
POST/v1/sourcesCreate source — title, source_type, tier; content or url for managed/indexed
GET/v1/sourcesList — query: source_type, status, tags, q
GET/v1/sources/:idFetch — query: return_mode, query
POST/v1/searchBody: query, filters, top_k, return_mode
GET/v1/wiki/indexWiki index.md
GET/v1/wiki/pagesRead page — path required; return_mode, query
POST/v1/wiki/pagesWrite page — path, content
GET/v1/wiki/logMaintainer log — query: tail
POST/v1/notesConvenience note — title, content (managed note source)
GET/v1/skillsList skill sources
GET/v1/skills/:idFetch skill — return_mode, query
*/mcpMCP Streamable HTTP
GET/healthHealth check (no auth)