← Files BodhiKitARCHIVED FILE

skills/notes-setup/references/notes-file.md

2.07 KB · Nov 21, 2026 · 12:41 UTC

↓ Download file

See the change to this file →

# The notes file — `learningWithBodhi/.bodhi-notes.json`

Loaded by `notes-setup` skill and by the script-unavailable fallback only. No other skill
reads this file. It holds the learner's notes choice for every course, and sits beside
`.bodhi-profile.json` (found the same way: walking up from the course folder).

`bodhi-state` writes it, never a skill: `notes-set` records the choice the learner agreed to,
and `notes-offered` records that the one-time offer was made. `notes-show` reads it. `verify`
checks it when it exists. `notes-sync` does the copying, and `notes-set` runs it across every
course when a choice is first recorded.
At session close the Stop hook runs `notes-sync`; in ChatGPT or Codex without hooks, the runtime adapter's close procedure runs it.

**No file means no choice and no offer** — every learner on 1.26.1.

```json
{
  "version": 1,
  "choice": "vault | files | off | null",
  "app": "obsidian | null",
  "location": "/absolute/path/to/the/vault | null",
  "agreedOn": "YYYY-MM-DD | null",
  "offerMadeOn": "YYYY-MM-DD | null",
  "announced": ["<course folder name>"]
}
```

| Field | Meaning |
|---|---|
| `choice` | `vault`: copy into the app's vault. `files`: keep `Syllabus.md` in each course folder, copy nothing. `off`: write neither; nothing written before is deleted. `null`: never chosen. |
| `app`, `location` | The app and its vault folder, for `vault`. Kept when the learner turns notes off, so turning them back on can start from them. |
| `agreedOn` | The day the learner last agreed to `vault` or `files`. |
| `offerMadeOn` | The day the one-time offer was made. Once set, the offer is never made again. |
| `announced` | Courses whose first arrival in the vault has been reported to the learner; later copies are silent. |

Unknown fields are kept on every write. The apps offered on a host come from `notes-show`
(`appsOffered`), never from this file.

**The home** is `<location>/Learn with Bodhi/`: `Courses.md`, then one folder per course
holding `Syllabus.md` and `revision/`. BodhiKit writes nothing in the vault outside it, and
reads nothing back from it.

SHA-256: 8440f58a14f115a7450f63bc4150cb6ca1d894b8d8e7e58b16493efa962ab351