librenotes/CLAUDE.md

librenot.es

Cloud-native multi-tenant notes application built on Notesium (MIT).

Project

• Repo: https://git.librete.ch/public/librenotes
• Remote: ssh://git.librete.ch:41240/public/librenotes.git (configure SSH user in ~/.ssh/config)
• Stack: Go backend (forked from Notesium), vanilla JS frontend
• License: MIT (inherited from Notesium)

Development rules

• NEVER use sed for file editing — use perl instead
• NEVER install packages on host — no pip, no nix-shell for deps
• NEVER use python for quick scripts — use perl
• NEVER commit to the wrong repo — this is /home/mwc/Coding/librenotes, not /home/mwc/notes

Wave pipelines

• gt-issue-* pipelines use tea CLI with --login libretech
• gh-issue-* pipelines use gh CLI
• Personas must be registered in wave.yaml under personas: key — files alone aren't enough
• wave.yaml is gitignored (local config)
• .env contains GITEA_TOKEN (gitignored)

Gitea

• Instance: https://git.librete.ch
• Auth: tea CLI, login name libretech (matches the Gitea username)
• API: https://git.librete.ch/api/v1
• Issues: https://git.librete.ch/public/librenotes/issues