shodh-local

Original source / Raw SKILL.md

---
name: shodh-local
summary: Local-first cognitive memory for AI agents with semantic recall, GTD todos, and knowledge graph.
description: Local Shodh-Memory v0.1.74 (offline cognitive memory for AI agents). Use for persistent remembering, semantic recall, GTD todos/projects, knowledge graph. Triggers: \"remember/save/merke X\", \"recall/Erinnere/search memories about Y\", \"todos/add/complete\", \"projects\", \"proactive context\", \"what learned about Z\". Server localhost:3030 (amber-seaslug), key in TOOLS.md. Hebbian learning, 3-tier (working/session/LTM), TUI dashboard.
---

# Shodh-Local (v0.1.74)

Local-first brain for OpenClaw. Offline, learns with use.

## Config (TOOLS.md)
- **Binary**: `./shodh-memory-server` (or add to PATH)
- **Server**: `localhost:3030`
- **Data**: `./shodh-data`
- **Key**: `<YOUR-API-KEY>` (X-API-Key, generate via shodh-memory-server)
- **Manage**: `process` tool (session `amber-seaslug`)
- **TUI**: `cd tools/shodh-memory && ./shodh-tui` (graph/activity)

## Quick Use
```
KEY='<YOUR-API-KEY>'
curl -s -X POST http://localhost:3030/api/remember \\
-H &quot;Content-Type: application/json&quot; -H &quot;X-API-Key: $KEY&quot; \\
-d &#39;{&quot;user_id&quot;: &quot;henry&quot;, &quot;content&quot;: &quot;Test memory&quot;, &quot;memory_type&quot;: &quot;Learning&quot;, &quot;tags&quot;: [&quot;test&quot;]}&#39;
```

## Core Tools
- **Remember**: `/api/remember` (types: Learning/Observation/Conversation/Task/Preference)
- **Recall**: `/api/recall` (semantic) | `/api/recall/tags`
- **Proactive**: `/api/proactive_context` (auto-relevant)
- **Todos**: `/api/todos/add` | `/api/todos` | `/api/todos/complete`
- **Projects**: `/api/projects/add` | `/api/projects`
- **Summary**: `/api/context_summary`

Full API: [reference/api.md](reference/api.md)

## Best Practices
- **User ID**: `henry` (main), `openclaw` (system), `task-XYZ` (sub-agents)
- **Tags**: Always add for filtering (e.g. [&quot;openclaw&quot;, &quot;project-backend&quot;])
- **Before reply**: Recall recent context for continuity
- **Heartbeat**: Check todos daily
- **Maintenance**: Restart server weekly (`process kill amber-seaslug` + restart)

Read [reference/examples.md](reference/examples.md) for OpenClaw patterns.

---

## Referenced Files

> The following files are referenced in this skill and included for context.

### reference/api.md

```markdown
# Shodh API Endpoints

## Memory
| Method | Endpoint | Desc |
|--------|----------|------|
| POST | /api/remember | Store memory |
| POST | /api/remember/batch | Batch store |
| POST | /api/recall | Semantic search |
| POST | /api/recall/tags | Tag search |
| POST | /api/proactive_context | Context-aware |
| POST | /api/context_summary | Summary |
| GET | /api/memory/{id} | Get by ID |
| DELETE | /api/memory/{id} | Delete |

## Todos
| Method | Endpoint | Desc |
|--------|----------|------|
| POST | /api/todos | List/filter |
| POST | /api/todos/add | Create |
| POST | /api/todos/complete | Done |
| POST | /api/todos/delete | Delete |

## Projects
| Method | Endpoint | Desc |
|--------|----------|------|
| GET | /api/projects | List |
| POST | /api/projects/add | Create |

**Headers**: Content-Type: json, X-API-Key: [key]

**Health**: GET /health (public)
```

### reference/examples.md

```markdown
# OpenClaw Examples

## Remember Conversation Insight
```bash
curl ... -d '{\"user_id\":\"henry\",\"content\":\"Henry prefers efficient German replies, no blabla.\",\"memory_type\":\"Preference\",\"tags\":[\"henry\",\"vibe\"]}'
```

## Recall Prior Work
```bash
curl ... /api/recall -d '{\"user_id\":\"henry\",\"query\":\"openclaw setup preferences\", \"limit\":5}'
```

## Add Todo
```bash
curl ... /api/todos/add -d '{\"user_id\":\"henry\",\"content\":\"Review shodh integration\",\"project\":\"OpenClaw\",\"priority\":\"high\",\"contexts\":[\"@computer\"]}'
```

## Proactive Context
```bash
curl ... /api/proactive_context -d '{\"user_id\":\"henry\",\"query\":\"current task\"}'
```
```



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "doobidoo",
  "slug": "shodh-local",
  "displayName": "Shodh Local",
  "latest": {
    "version": "1.0.1",
    "publishedAt": 1770024612915,
    "commit": "https://github.com/clawdbot/skills/commit/5e6c63a1a9f579e7026f734d5cde59cd3340cf3b"
  },
  "history": []
}

```