https://nemonist.com/api/v1 and takes a nemonist key as a bearer token:
Endpoints
Memory
GET /memory-filereturns one project’s memory: each file’s text and summary, and the latest memory reads and edits with their reason, model and time. Send the contents of the project’s.nemonist/keyin thex-nemonist-workspace-keyheader.DELETE /memoryerases every project’s memory under your account, and the request records kept for it. It cannot be undone.GET /memory-graphreturns the project’s memory graph: notes, turns, judgments, work items and jobs, and how they connect. Named byx-nemonist-workspace-key, like/memory-file.POST /inboxqueues a message for the project’s next turn; your agent sees it then, andGET /inboxlists each message with the reply it got.
Folders
The folder endpoints take your account’s API key alone and answer only your own folders; another member’s folder is not found. Each folder’s id (fld_...) comes from GET /folders.
- Read: the folder, one note, its memory graph, its server-side tool use, its inbox and its jobs.
GET /folders/{id}/historylists the requests it served;GET /folders/{id}/history/{commit}returns one exactly as your client sent it.GET /folders/{id}/exportreturns every note, work item and judgment as JSON Lines.- Files: list, upload (one signed URL, or multipart for a large file), download, and delete for good.
- Change: rename, nightly sleep on or off, issue or revoke a key, merge into another folder, erase.
From a terminal: nemonist
nemonist reads a folder from your shell the way git log and gh read a repository. It is one Python 3 file with nothing else to install:
export lines to ~/.zshrc or ~/.bashrc to keep them. Run it inside a project: it reads the folder from the nearest .nemonist/config above you, or takes --folder fld_....
A commit can be a tag or the first characters of its id (at least four).
--json prints the API’s own objects. When the kept history cannot rebuild a version, or cannot say whether a note existed at that commit, nemonist says so and exits 1 rather than guess. nemonist blame marks a line it cannot place with ? and never names a guessed commit. Your key is sent only to https://nemonist.com; to use another API, name it yourself with --api or NEMONIST_API. A .nemonist/config that names any other endpoint is refused, so a cloned project cannot redirect your key.
Errors
Errors are JSON,{"error": {"code": ..., "message": ...}}. See Errors and retries.