Coding Agent (MCP client)
    │  stdio JSON-RPC
    ▼
everos-mcp (this package) ──HTTP──▶ EverOS REST API (:8000)
                                         │
                                    Markdown + SQLite + LanceDB

pip install everos-mcp
# or from source:
pip install -e .

everos server start
# Verify: curl http://localhost:8000/health → {"status":"ok"}

{
  "mcpServers": {
    "everos": {
      "command": "python",
      "args": ["-m", "everos_mcp.server"],
      "env": {
        "EVEROS_API_URL": "http://localhost:8000"
      }
    }
  }
}

{
  "mcpServers": {
    "everos": {
      "command": "python",
      "args": ["-m", "everos_mcp.server"],
      "env": {
        "EVEROS_API_URL": "http://localhost:8000"
      }
    }
  }
}

codex mcp add everos -- python -m everos_mcp.server

User: "Remember that I prefer pnpm over npm for this project."

Claude calls: everos_memory_add(sender_id="alice", content="Prefers pnpm over npm",
               role="user", session_id="<current>")

User (next session): "Set up the package scripts for me."

Claude calls: everos_memory_search(query="package manager preference", user_id="alice")
  → "Prefers pnpm over npm" found — uses pnpm without re-asking

~/.everos/
  default/default_project/users/alice/
    user.md                        # user profile
    episodes/episode-2026-07-14.md  # daily conversation log

# Install with dev deps
pip install -e ".[dev]"

# Run tests
pytest src/everos_mcp/tests/ -v

# Manual smoke test (requires running EverOS)
EVEROS_API_URL=http://localhost:8000 python -m everos_mcp.server