# Project pack: TiddlyWiki @ 999763a

Facts about **TiddlyWiki** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> TiddlyWiki is a non-linear notebook made of small notes called tiddlers. The whole wiki, with its editor, can live in one HTML file that works offline, or run on a small Node.js server. Plugins, themes and a built-in macro language let you turn it into a journal, task list, recipe book or personal website.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Use it in a web browser; nothing to install on your computer.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://tiddlywiki.com
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/TiddlyWiki/TiddlyWiki5
- Pinned commit: `999763abb080adc68595dbee7526f315da28a044`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/TiddlyWiki/TiddlyWiki5/archive/999763abb080adc68595dbee7526f315da28a044.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://tiddlywiki.com/#Documentation
- Live demo: https://tiddlywiki.com/. The documentation site is itself a TiddlyWiki, so you can try the editor right there.
- Licence: **BSD-3-Clause**. Free to use, change and share, even commercially. Keep the copyright notice, and do not use the authors' names to endorse your version.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/TiddlyWiki/TiddlyWiki5 bespoke-tiddlywiki
  cd bespoke-tiddlywiki
  git checkout --detach 999763abb080adc68595dbee7526f315da28a044
  # Prepare development requirements and local configuration first.
  npm install
  node ./tiddlywiki.js ./editions/tw5.com-serve --listen
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  npm install -g tiddlywiki
  tiddlywiki mywiki --init server
  tiddlywiki mywiki --listen
  # then open http://127.0.0.1:8080
  ```
- Tools these commands use: A browser for single-file use, or Node.js 20+ for the server version
- Develop: `node ./tiddlywiki.js ./editions/tw5.com-serve --listen`
- Test: `npm test`
- Check/lint: `npm run lint`
- Stack: javascript (TiddlyWiki widgets and wikitext, Node.js). Difficulty for a non-developer with an AI: **easy**. Most changes are new tiddlers: a stylesheet, a template or a small widget written in wikitext, with no build step. Changing the core engine is plain JavaScript.
Personal data: **yes**. Stored in: One HTML file, or a folder of tiddler files when run with Node.js. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/tiddlywiki/999763a/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/tiddlywiki/999763a/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/tiddlywiki/999763a/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/tiddlywiki/999763a/r3/SKILL.md)