Skip to main content
Every endpoint is under https://nemonist.com/api/v1 and takes a nemonist key as a bearer token:
Pages in this section are generated from nemonist’s OpenAPI spec; each has a playground that sends the request to nemonist with your key.

Endpoints

Memory

  • GET /memory-file returns 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/key in the x-nemonist-workspace-key header.
  • DELETE /memory erases every project’s memory under your account, and the request records kept for it. It cannot be undone.
  • GET /memory-graph returns the project’s memory graph: notes, turns, judgments, work items and jobs, and how they connect. Named by x-nemonist-workspace-key, like /memory-file.
  • POST /inbox queues a message for the project’s next turn; your agent sees it then, and GET /inbox lists 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}/history lists the requests it served; GET /folders/{id}/history/{commit} returns one exactly as your client sent it.
  • GET /folders/{id}/export returns 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:
Add the two 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.