AGENTS.md pack

# Memuron — agent memory instructions

Memuron is governed institutional memory for AI agents.
There is **no npm SDK**. Use HTTPS REST, the PyPI CLI (`uvx memuron`), or remote MCP.

## Connection

- API base: `https://api.memuron.com/memuron`
- MCP (OAuth): `https://api.memuron.com/mcp`
- OpenAPI: `https://api.memuron.com/docs`
- Create API keys: https://console.memuron.com/api-keys
- Auth: `Authorization: Bearer arth_sk_…`
- Managed keys bind to an org. Optional header: `X-Memuron-Tenant-Id: org_…`
- Optional audit: `X-Memuron-Actor-Id: user_…`

## Required workflow

1. List spaces: `GET /spaces` — never invent `space.*` tokens.
2. Search with GraphFS: `POST /spaces/query` with `cwd` like `/spaces/space.personal`.
   - Prefer small results: `head`, `--limit`, `select id,type,title,preview`.
   - On errors, read `GET /spaces/query/manual` and retry.
3. Or hybrid search: `POST /memories/search` with `query`, `k`, optional `space`.
4. Fetch one node only with an exact ID: `GET /memories/{id}`.
5. Write with Guardian ingest: `POST /memories` → poll `GET /jobs/{job_id}`.
6. Update/delete only after resolving a real ID and explicit user intent for deletes.

## GraphFS query examples

```
ls | head 20
rg "authentication" | head 10 | select id,type,title
semantic "why did the deployment fail" --limit 10
find --id MEMORY_ID | related --limit 10
```

## Do not

- Invent memory IDs, space tokens, or tenant IDs.
- Call billing, webhook, console, `/engine`, or `/actions/*` routes.
- Append contradictory facts as new rows — let Guardian update in place.
- Paste API keys into public chat logs.

## CLI alternative

```bash
export MEMURON_API_KEY="arth_sk_…"
uvx memuron config set --base-url https://api.memuron.com --api-key "$MEMURON_API_KEY"
uvx memuron query --cwd /spaces/space.personal --query 'ls | head 20'
```