silverbulletmd / silverbullet
An open source personal productivity platform built on Markdown, turbo charged with the scripting power of Lua
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing silverbulletmd/silverbullet in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler viewSilverBullet SilverBullet is a Programmable, Private, Browser-based, Open Source, Self Hosted, Personal Knowledge Management Platform. _Yowza!_ That surely is a lot of adjectives to describe a browser-based Markdown editor programmable with Lua. Let’s get more specific. In SilverBullet you keep your content as a collection of Markdown Pages (called a Space). You navigate your space using the Page Picker like a traditional notes app, or through Links like a wiki (except they are bi-directional). If you are the **writer** type, you’ll appreciate SilverBullet as a clean Markdown editor with Live Preview. If you have more of an **outliner** personality, SilverBullet has Outlining tools for you. Productivity freak? Have a look at Tasks. More of a **database** person? You will appreciate Objects and Queries. And if you are comfortable **programming** a little bit — now we’re really talking. You will love _dynamically generating content_ with Space Lua (SilverBullet’s Lua dialect), or to use it to create custom Commands, Page Templates or Widgets. Much more detail can be found on silverbullet.md Installing SilverBullet Check out the instructions. Developing SilverBullet SilverBullet's frontend is written in TypeScript and built on top of the excellent CodeMirror 6 editor component. Additional UI is built using Preact. ESBuild is used to build the frontend. The server backend is written in Go. If you're considering contributing changes, be aware of the LLM use policy. Code structure • : The SilverBullet client, implemented with TypeScript • : The SilverBullet server, written in Go • : Set of built-in plugs that are distributed with SilverBullet • : A set of libraries (space scripts, page templates, slash templates) distributed with SilverBullet • : Useful APIs for use in plugs • : Useful libraries to be used in plugs • : TypeScript wrappers around syscalls • : Various (client) types that can be references from plugs • * the plug compiler • : Useful scripts • : silverbullet.md website content Requirements • Node.js 24+ and npm 10+: Used to build the frontend and plugs • Go: Used to build the backend The project includes and files. If you use nvm or another Node version manager, it will automatically use the correct Node.js version: It's convenient to also install air for development, this will automatically rebuild both the frontend and backend when changes are made: Make sure your is in your $PATH. First, install dependencies: To build everything and run the server: Alternatively, to build: To run the resulting server: Useful development tasks Build a docker container Note, you do not need Node.js nor Go locally installed for this to work: To run: