/remnic-entities

name: remnic-entities
description: Browse entities in the Remnic knowledge graph and surface their facts and relationships. Trigger phrases include "tell me about the entity", "look up", "what do we know about".
allowed-tools:
  - remnic_entity_get

When to use

Use when the user names a specific project, person, service, or concept and asks what is known about it. Entities are the structured graph view of memory — facts and relationships rather than free text.

Triggers:

• "Tell me about the entity …"
• "Look up …"
• `/remnic:entities <name>` slash command invocation.
• Any reference to a named thing that could have linked facts.

Inputs

• `name` (required) — canonical entity name, ideally as the user wrote it.
• Optional: entity type hint (project, person, service, tool).

Procedure

1. Extract the entity name from the user's message. Preserve capitalization. 2. Call `remnic_entity_get` with that name. 3. If found, present facts, relationships, and a last-updated timestamp in a compact block. 4. If missing, say so and offer to create it via `remnic-remember` with the user's permission. 5. If multiple candidates match, list them briefly and ask which the user meant.

Efficiency plan

• Do not fetch speculatively for every proper noun — only when the user asks or the task depends on it.
• Cache the entity payload within the current turn.
• Pair with `remnic-recall` when unstructured context would round out the view.

Pitfalls and fixes

• **Pitfall:** Guessing entity names. **Fix:** Use the user's wording; disambiguate rather than inventing.
• **Pitfall:** Dumping the full payload. **Fix:** Summarize into facts, relations, last-updated.
• **Pitfall:** Treating missing entities as a bug. **Fix:** Missing just means the graph has not captured it yet.

Verification checklist

• [ ] `remnic_entity_get` was called with a user-supplied or user-confirmed name.
• [ ] Output shows facts, relationships, and timestamps in a compact view.
• [ ] Missing entities are acknowledged plainly with an offer to create.
• [ ] Canonical `remnic_entity_get` was used over legacy `engram_entity_get`.

> Tool names: canonical name is `remnic_entity_get`. The legacy `engram_entity_get` alias remains accepted during v1.x.