# Project pack: Logseq @ 533ac43

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

> Logseq is a note-taking app built around a daily journal page. You write in bullet points, link to any page or idea with double square brackets, and everything that mentions it shows up there automatically. It also handles to-dos, flashcards and PDF notes, with themes and community plugins. The pinned 2.0.2 release is the new "database version": notes live in a local database instead of Markdown files, and your notes stay on your own device.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install the project's own desktop app or installer. 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/logseq/logseq/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/logseq/logseq
- Pinned commit: `533ac4382a7b69baa98de3a973bff90305b212dc`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/logseq/logseq/archive/533ac4382a7b69baa98de3a973bff90305b212dc.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://docs.logseq.com
- Live demo: https://app.logseq.com. The official web version, which may run newer code than the pinned 2.0.2. Notes are stored in your browser, not on Logseq's servers; try it with a test graph.
- Licence: **AGPL-3.0-only**. Free to use and change. If you run a changed version that other people use over the internet (not just you or your household), you must offer them your source code under the same licence. Private use has no extra obligations.

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

  ```sh
  git clone https://github.com/logseq/logseq bespoke-logseq
  cd bespoke-logseq
  git checkout --detach 533ac4382a7b69baa98de3a973bff90305b212dc
  # Prepare development requirements and local configuration first.
  # Setup notes: browser app on http://localhost:3001; pnpm dev-electron-app for the desktop app
  pnpm install && pnpm watch
  ```

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

  ```sh
  # Easiest: download the 2.0.2 desktop app from https://github.com/logseq/logseq/releases/tag/2.0.2
  # or try it in your browser at https://app.logseq.com.
  # Or run the official web app image on this computer with Docker:
  docker run -d --rm -p 127.0.0.1:3001:80 ghcr.io/logseq/logseq-webapp:latest
  # Then open http://localhost:3001 in Chrome or Edge.
  ```
- Tools these commands use: The desktop or phone app, or a modern Chromium-based browser for the web app (HTTPS needed for remote access), For development, Node.js and pnpm, Java and the Clojure CLI, and babashka (bb)
- Develop: `pnpm install && pnpm watch   # browser app on http://localhost:3001; pnpm dev-electron-app for the desktop app`
- Test: `bb dev:lint-and-test`
- Check/lint: `bb dev:lint-and-test   # bb lang:validate-translations and bb lang:lint-hardcoded for text changes`
- Build: `pnpm release   # static web app in static/; pnpm release-electron for the desktop app`
- Stack: clojurescript, clojure, typescript, javascript, css (shadow-cljs, Rum (React), DataScript, Electron, Capacitor, Tailwind CSS). Difficulty for a non-developer with an AI: **advanced**. config.edn, custom.css, themes and a large plugin marketplace cover most personal changes. The app itself is written in ClojureScript, which few people (and fewer AIs) know well, needs Java, Clojure and Node to build, and changes quickly now that the database version has shipped. Prefer a plugin or custom.css.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CODEBASE_OVERVIEW.md`, `CONTRIBUTING.md`.
Personal data: **yes**. Stored in: On your device. Each graph is a SQLite database (in the browser's private storage for the web app). Older Markdown "file graphs" can be imported and converted; Org-mode files are not supported. Nothing is sent to Logseq unless you turn on sync. Secrets are entered by the person, never in chat.

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