inland-empire

majiayu000 的头像作者 majiayu000

统一内存基板。存储事实、模式和上下文。使用记住、咨询和统计命令进行查询。

📖 中文导读:统一内存基板。存储事实、模式和上下文。使用记住、咨询和统计命令进行查询。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: inland-empire description: Unified memory substrate. Store facts, patterns, and context. Query with remember, consult, and stats commands. license: MIT metadata: version: 1.0.0 dependencies: required: - memory_libsql - memory_graph optional: - openmemory env_vars: required: [] optional: - LIBSQL_URL - LIBSQL_AUTH_TOKEN - MEM0_API_KEY - POSTGRES_URL - INLAND_EMPIRE_STATE_DIR - INLAND_EMPIRE_EVENT_HOME membrane: version: 1 absorbs: - event_type: action.completed priority: normal - event_type: rhetoric.pattern.detected priority: normal - event_type: feedback.useful priority: high - event_type: feedback.not_useful priority: high emits: - event_type: memory.fact.stored - event_type: memory.pattern.stored - event_type: memory.context.stored - event_type: memory.consulted - event_type: memory.evicted rate_limits: max_absorb_per_minute: 100 max_emit_per_minute: 50


Inland Empire

"This is your gut feeling. The raw data of the soul. When logic fails, consult the Empire."

Capabilities

The Inland Empire unifies three memory backends but only exposes sanitized aliases (fact_memory, pattern_memory, context_memory). Internals (MCP, mem0, JSONL) are hidden.

Alias Memory Type Backend Storage Notes
fact_memory fact mcp-memory-libsql Graph entities/relations Defaults to local SQLite fallback
pattern_memory pattern mem0 Hosted API (MEM0_API_KEY) or self-hosted Postgres (POSTGRES_URL)
context_memory context JSONL Local file (session_memory.jsonl) Always available

Backend detection

  • mem0 hosted: MEM0_API_KEY present
  • mem0 self-hosted: POSTGRES_URL present
  • mem0 disabled: neither credential; pattern memory gracefully skipped
  • LIBSQL_URL optional; if missing, a local SQLite file powers fact memory
  • INLAND_EMPIRE_STATE_DIR overrides the storage directory (tests, sandboxes, multi-project)

Commands

remember

Store a memory across configured backends.

python3 inland-empire.py remember "<text>" [--type fact|pattern|context]

Examples:

python3 inland-empire.py remember "User prefers verbose error messages"
python3 inland-empire.py remember "The auth flow has race conditions" --type pattern

consult

Query stored memories with optional depth and type filters. Results contain backend aliases, partial-result indicators, and normalized metadata.

python3 inland-empire.py consult "<query>" [--depth shallow|deep] [--type fact|pattern|context]

Example:

python3 inland-empire.py consult "user preferences" --depth deep --type pattern

Response shape

{
  "status": "ok",
  "command": "consult",
  "result": {
    "query": "user preferences",
    "depth": "deep",
    "results": [
      {
        "origin": "pattern",
        "summary": "User prefers verbose error messages",
        "score": 0.812,
        "observed_at": null,
        "backend": "pattern_memory",
        "partial": false,
        "metadata": {
          "id": "mem0_123",
          "user_id": "agent_subconscious",
          "created_at": "2024-01-15T10:30:00Z",
          "updated_at": "2024-01-15T10:30:00Z",
          "mode": "hosted"
        }
      }
    ],
    "metadata": {
      "requested_backends": ["fact_memory", "pattern_memory"],
      "completed_backends": ["pattern_memory"],
      "timed_out_backends": ["fact_memory"],
      "partial": true
    }
  }
}

stats

Display backend health, detection mode, and basic counts (context entries).

python3 inland-empire.py stats

When to Use

  • Store hunches, preferences, and soft context that doesn't belong in files
  • Recall project context after breaks
  • Detect patterns across sessions
  • Build institutional memory for recurring issues