# Project pack: SilverBullet @ 3ee1f82

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

> SilverBullet is a self-hosted notebook where every page is a plain Markdown file. It adds backlinks, tasks, and live queries (for example "all my open tasks tagged #home"), and lets you write small scripts in the Space itself. It works offline in the browser and keeps your files on your own server.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Download the prebuilt program for your system and run it. No Docker.
- 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://raw.githubusercontent.com/silverbulletmd/silverbullet/HEAD/README.md
- 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/silverbulletmd/silverbullet
- Pinned commit: `3ee1f82deedf4d083bb1adde43f131448082abc6`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/silverbulletmd/silverbullet/archive/3ee1f82deedf4d083bb1adde43f131448082abc6.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://silverbullet.md/Manual
- Live demo: https://play.silverbullet.md/. Public playground. Don't enter anything private.
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

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

  ```sh
  git clone https://github.com/silverbulletmd/silverbullet bespoke-silverbullet
  cd bespoke-silverbullet
  git checkout --detach 3ee1f82deedf4d083bb1adde43f131448082abc6
  # Prepare development requirements and local configuration first.
  npm install
  npm run build
  npm test
  ```

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

  ```sh
  docker run -d --name silverbullet -p 3000:3000 -v silverbullet-space:/space ghcr.io/silverbulletmd/silverbullet:latest
  # then open http://localhost:3000
  ```
- Tools these commands use: Docker for a trial, Node 22 and the Go toolchain for development
- Develop: `npm run build`
- Test: `npm test`
- Check/lint: `npm run lint`
- Stack: typescript, go, lua (Deno-free TypeScript client, Go server, CodeMirror). Difficulty for a non-developer with an AI: **moderate**. Most personal changes are pages, templates and Lua scripts inside your own space, with no fork. Changing the editor or server itself means working in a TypeScript client and a small server.
Personal data: **yes**. Stored in: Markdown files in the space folder (/space in Docker). Secrets are entered by the person, never in chat.

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