Skip to main content
EOS
API referenceSign in

Memory API · v1

Memory layer for AI agents
that need to understand
engineering teams.

Semantic search over your codebase, decisions, and conversations — built on a knowledge graph that knows who works on what, why, and when. One endpoint. SDK in any language. Free to start.

Get an API key, free →Read the spec

No credit card. 1,000 free requests every month.

Quick start

From signup to first search in under a minute.

terminal
$ npm install -g @eos-ai/cli

$ eos init
  EOS Memory API — setup
  API key  (eos_…) ›  eos_••••••••••••••••
  ✓ Credentials saved to ~/.eos/credentials.json

$ eos search "what changed in auth last week"
  Knowledge nodes (3)
   1. [decision]      Switched session storage to httpOnly cookies
      score 92.4%  ·  Apr 28  ·  api/auth, web/middleware  ·  alex
   2. [insight]       Refresh-token rotation closes the CVE flagged in audit-22
      score 87.1%  ·  Apr 27  ·  api/auth  ·  jamie

Prefer code? The same flow works directly from the SDK — npm i @eos-ai/sdk and new EosClient().

Why it's different

Built for agents, not for analysts.

Semantic, not keyword

Hybrid retrieval — pgvector embeddings, entity matching, and reciprocal rank fusion. Ask in plain English and get the right code, decisions, and conversations.

Code-aware

We index your repos, not just docs. Results carry the files, owners, and PRs that gave them context — agents can follow the trail back to the source.

Knowledge graph backed

Every result links into a graph of insights, decisions, team norms, and entity context. You don't just retrieve text — you retrieve relationships.

One endpoint

POST /api/v1/memory/search. Bearer auth, JSON in, JSON out. Idiomatic SDKs for Node and Python; thin enough to wrap from anywhere.

Free tier

Free, forever-ish.
No card required.

Sign up, get an API key, run searches. We'll never ask for a credit card to get started. Pro tier with higher limits and write access is coming soon — when it ships, your free tier keeps working.

Free

  • 1,000 requests / month
  • Semantic memory search
  • @eos-ai/sdk + @eos-ai/cli
  • Knowledge graph reads
  • Write API (Builder tier — coming soon)
  • Slack ingestion + graph queries (Builder)
  • Custom retention + SSO (Scale)

Pro tier coming soon — pricing page in progress.

The endpoint

One call, the whole memory.

POST/api/v1/memory/search
Bearer eos_…
// Request
{
  "query": "what changed in auth last week",
  "limit": 5,
  "include_conversations": true
}

// Response (truncated)
{
  "data": {
    "query":   "what changed in auth last week",
    "results": [
      {
        "id":           "…",
        "node_type":    "decision",
        "content":      "Switched session storage to httpOnly cookies",
        "score":        0.924,
        "related_repos":      ["eos-xyz/eos-monorepo"],
        "related_developers": ["alex"],
        "created_at":   "2026-04-28T18:11:02Z"
      }
    ],
    "conversations": [ … ],
    "total":         5
  },
  "meta": {
    "request_id":      "…",
    "took_ms":         142,
    "indexing_status": "ready"
  }
}

Full schema, rate limits, and error codes: /developers/api-reference.