HTTP API
Use Woolly from any program with a small local API.
Start the server:
woolly serveIt also serves the review page at http://127.0.0.1:11435. It listens on 127.0.0.1:11435, right next to Ollama's 11434. It only accepts requests from your own machine and blocks requests from websites.
Remember
curl -X POST localhost:11435/api/remember \
-d '{"content": "Prefers dark mode", "key": "ui.theme"}'Recall
curl -X POST localhost:11435/api/recall \
-d '{"query": "dark mode", "limit": 5}'{
"mode": "keyword",
"results": [
{ "memory": { "id": "…", "content": "Prefers dark mode", "key": "ui.theme" }, "score": 1.05 }
]
}All endpoints
| Method | Path | Body |
|---|---|---|
POST | /api/remember | content, plus optional key, tags, source |
POST | /api/recall | query, plus optional limit, include_all |
GET | /api/memories | Add ?all=1 for everything |
GET | /api/memories/{id} | |
PATCH | /api/memories/{id} | Any of content, key, tags |
DELETE | /api/memories/{id} | |
GET | /api/profile | Add ?format=markdown for Markdown |
GET | /api/conflicts | |
POST | /api/resolve | keep_id |
GET | /api/version |