Velkommen
This is your blyant records site. Every Markdown file in records/ becomes a page;
this repository carries the machinery to write and publish them.
blyant records publishes straight from your editor, with helpers along the way. They run in well-known AI agents — or with no model at all, and even with your own local one; the README covers both.
No helpers required, though: write or drop .md files into records/ by
hand and they publish just the same.
Until your first record lands, an example recording below shows what a published conversation looks like — it disappears automatically the moment you add a record of your own.
The helpers
The essentials:
/record— transcribe the conversation into a record until/esc; start with#tags(/record #linux How to do it right) to file it underrecords/linux//stick— feature a record: pin it to the top and clear its draft flag/cpd— stage everything, commit, push — and the push publishes the site/esc— stop active modes; name one to stop only it
The full set lives in .ai/skills/ —
drafts-only recording, commit variants, diff summaries, spelling corrections, and a few voices.
Publishing
Fork this repository, enable Actions in your fork’s settings, then push to
main. Your site appears at https://<your-user>.codeberg.page/<your-repo>/ — nothing to configure; the
owner and repository name are derived from the push itself.
The look is the Fuglekasse theme;
its colors, greeting font and the tiny footer links all live in
tools/hugo/hugo.yaml — repoURL is the codeberg door.
If you want a license link in the footer, add your own
records/LICENSE.md. Itstitle:becomes the link text (defaults to “License”).
When you have found your footing, write your own front page: create
records/_index.md and it replaces this default one, which ships with the
theme.