Buildable tools and devices: what they do, what you need, how to build or use them, and a worked example. The interactive ones open a tool.

Open the free tool →

Buildable Instrument

The Servitor Ledger

A local record of constructs, feedings, readings and closings, exportable as a plain text file.

Open the tool

What it is

To keep a working auditable without keeping it in your head.

At a glance

Inputs
A construct name; an event (created, fed, read, closed); a note; a timestamp.
Outputs
An append-only JSONL file and a weekly summary.

How to do it

  1. Create `ledger.jsonl` and add one line for the construct's creation.
  2. After every feeding or reading, append a line with the date and a short note.
  3. At the close, append the close line and set the construct's status to closed.
  4. Once a week, read the last seven lines for each open construct.
  5. If a construct has no entry for two weeks, close it or explain why.

What you need

  • A text file
  • A script or a notes app
  • A weekly review

A worked example

A line: {"ts":"2026-11-07T09:12:00+11:00","construct":"VEL-ETH-8","event":"fed","note":"one minute, Mercury hour"}. The weekly review shows three feeds and no result; the practitioner closes it early.

Variations

  • Use a SQLite table if you want queries.
  • Add a `result` field and count how often a construct's task actually happened.
  • Keep one ledger for all constructs, with a `construct` field, rather than a file each.
Code sketch

This is a sketch, not a runnable program. It names the shape of the automation; the definitions are yours.

const line = { ts: new Date().toISOString(), construct, event, note };
await fs.appendFile('ledger.jsonl', JSON.stringify(line) + '\n');

Related entries

One of 110 entries in the Technomancy workshop. How a working is built Is it wrong somewhere?

Mentioned by 28

Every entry that names The Servitor Ledger, grouped by section.

✧ Practices 4

⌘ Protocols 4

⌬ Correspondences 4

▤ Glossary 4

◈ Constructs 3

⌁ Currents 2

✎ Prompts 1

More in Instruments

The entries either side of this one in the same section.

All of Instruments →

New entries, when they land

Occasional notes when a section of the grimoire is added or revised. No account, no tracking across sites, and one line to leave.

Grimoire updates only. Nothing is shared. Every note has an unsubscribe link.