kristianwindandClaude Opus 5
70d7398d5a
API-dokumentationen har fulgt med hele vejen — der er en prøve, der fejler, hvis en rute ikke står i openapi.yaml, og den fangede mig fire gange i går. Brugervejledningen har ikke fulgt med, og det er den, folk læser. Nyt: en side om beskeder — hvad der udløser en, hvorfor gentagne rettelser bliver slået sammen, push pr. apparat og mærket på ikonet. En om at åbne links i en anden browser, som mest af alt handler om, hvad en webside ikke kan: hverken se hvilke browsere der findes eller vælge mellem dem. Og en om tællingen af installationer, som ikke stod nogen steder overhovedet — en melding, der er slået til som udgangspunkt, har en pligt til at være skrevet ned, også når ingen har spurgt. Rettet: AI-siden beskrev to funktioner, hvor der nu er syv, og listen over hvad der sendes hvorhen var derfor forkert som en påstand om noget privat. Noter-siden manglede deling med en e-mailadresse og hvad `@Sofie` gør. Mail-siden manglede den anden vej ind i indbakken. Konfigurationen sagde stadig, at versionstjekket kun kunne se efter. Og tagbeskeden når nu frem. Den ER annonceringen — skrevet på produktets eget sprog til dem, der bruger det — og udgivelsen på GitHub blev fyldt med en autogenereret liste over commit-overskrifter i stedet, som er skrevet til dem, der læser koden. Nu står teksten øverst og listen under den. Linjen med linket til udgivelsen selv tages af: en side, der linker til sig selv, hjælper ingen. Dokumentationen bygges nu også på en PR. `mkdocs build --strict` fejler på et link til en side, der ikke findes, og at bygge først efter merge er at få det at vide på main. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
129 lines
5.8 KiB
Markdown
129 lines
5.8 KiB
Markdown
# verdande
|
|
|
|
Self-hosted tasks and projects, shared with the people you share the work with.
|
|
One binary with SQLite inside it — no database to provision, no second process.
|
|
|
|
**Verdande** is one of the three Norns: the one who spins *that which is becoming*.
|
|
Not what has been, and not what is fated to be — the thing you are in the middle
|
|
of. Which is what a to-do list is.
|
|
|
|
|
|
|
|
## What it is for
|
|
|
|
A fast, self-hosted task manager — projects, quick add, filters, notes and shared
|
|
lists — on your own hardware, with your own data. And with the integrations a
|
|
hosted product will not build for you: a real CalDAV server, an address you can
|
|
forward mail to, and an MCP endpoint so Claude can work your task list directly.
|
|
|
|
## What it does
|
|
|
|
- **[Quick add](quick-add.md) that reads what you type.** `file the VAT return
|
|
tomorrow at 10am p1 #Accounts @tax` becomes a task due tomorrow at 10:00,
|
|
priority 1, in Accounts, labelled tax. Danish and English, mixed freely in one
|
|
line.
|
|
- **Projects, sections, sub-tasks, labels, [saved filters](filters.md).** List,
|
|
board and calendar views, and foldable groups over the projects in the sidebar.
|
|
The calendar draws each task to its length — drag the foot to resize, the body
|
|
to move it.
|
|
- **Notes, beside the work.** Rich text to write in, Markdown on disk. Share a
|
|
single note with a person — by name, by email address, or by writing `@Sofie` in
|
|
the text — or file it in a project; `#project` and `[[another note]]` are links,
|
|
and a task shows what has been written about it.
|
|
- **Delegate, and snooze.** Hand a task to somebody and it is marked with an
|
|
arrow to them, gathered on a *Waiting on others* page. Snooze one to park it,
|
|
greyed, at the foot of the list until a moment you pick — without touching when
|
|
it is due.
|
|
- **Drag where it means something** — reorder a list or a board, file a project
|
|
under a group, drop a task on another project, or drop it on another day.
|
|
- **Sharing** with owner, editor and viewer roles. Anyone outside your instance
|
|
joins through an invite link.
|
|
- **Live sync** — a change made by somebody else appears without a refresh.
|
|
- **[Told when it matters](notifications.md).** A bell for what other people did to
|
|
what you share, pushed to your devices and counted on the app's icon in the Dock.
|
|
- **[AI that suggests and never writes](ai.md).** Optional, your own key. It tidies
|
|
the inbox, pulls the tasks out of a meeting note, writes a morning plan, turns
|
|
*"SV: SV: Vedr. levering uge 12"* into what the mail actually asks for, and
|
|
answers questions about your own notes with links to what the answer rests on —
|
|
every one of them as a line you accept, edit or refuse.
|
|
- **Repeating tasks** as RRULE, comments and attachments, and reminders that go
|
|
out as Web Push to an iPhone or a Mac.
|
|
- **[Anything can put a task in your inbox](mail.md)** — a mail to your own
|
|
address, or a POST from a shortcut on your phone, a script, or any service that
|
|
can call a URL.
|
|
- **[Your mail as an inbox](mailboxes.md).** Star a mail in Gmail, or flag one
|
|
over IMAP in iCloud or Fastmail, and it becomes a task — and the star or flag
|
|
comes off once it has, so a starred inbox empties as the tasks are made instead
|
|
of only filling up.
|
|
- **[Calendar](caldav.md) and [Claude](mcp.md)** connected over open standards
|
|
rather than private formats.
|
|
- **Six themes**, three dark and three light — including *Charcoal*, a warm
|
|
near-black after Apple Notes — and a size and typeface chosen apart from them.
|
|
- **Holds through a short network drop.** A save rides out a few seconds of no
|
|
signal and goes through when it comes back; a reload opens from what it last saw
|
|
rather than the browser's offline page. It installs as a PWA.
|
|
|
|
## What it looks like
|
|
|
|
|
|
|
|
*Upcoming, as a month. A week and a plain list are the other two, and a task can be
|
|
dragged from one day onto another.*
|
|
|
|
|
|
|
|
*The same project as a list, where sections read as bands. As a board they are
|
|
columns.*
|
|
|
|
|
|
|
|
*What you have handed to somebody else, grouped by whoever has it — and each row
|
|
marked with an arrow to them, so a delegated task reads as delegated wherever you
|
|
meet it.*
|
|
|
|
|
|
|
|
*Charcoal, the newest of six themes — a warm near-black after Apple Notes, with
|
|
amber where the accent green usually is.*
|
|
|
|
|
|
|
|
*Six themes — three dark, three light — chosen on the settings page, with the
|
|
typeface and how tightly it sits set apart from them.*
|
|
|
|
|
|
|
|
*Where [Gmail](mailboxes.md), the [calendar feed](caldav.md) and the
|
|
[mail-to-task address](mail.md) are connected.*
|
|
|
|
|
|
|
|
*Inviting somebody to the instance. There is no open registration — everybody
|
|
arrives through a link, and picks their own password. See
|
|
[signing in](signing-in.md).*
|
|
|
|
## Getting it running
|
|
|
|
verdande is built to be deployed as a **Rune** in
|
|
[Yggdrasil Panel](rune.md) — that is its home, and the manifest ships with it. It
|
|
runs anywhere Docker does as well.
|
|
|
|
```bash
|
|
docker run -d --name verdande \
|
|
-p 8080:8080 \
|
|
-v verdande-data:/data \
|
|
-e VERDANDE_BASE_URL=https://todo.example.dk \
|
|
ghcr.io/kristianwind/verdande:latest
|
|
```
|
|
|
|
Open the address, create the first account — that account is the administrator.
|
|
|
|
Running Yggdrasil Panel? [Install it as a Rune](rune.md) instead.
|
|
|
|
## What it will not do
|
|
|
|
No karma or points. No team workspaces. No native apps. No mail integration beyond
|
|
Gmail and the forwarding address. No languages beyond Danish and English. And no
|
|
sync protocol of its own — [CalDAV](caldav.md) and the [API](api.md) *are* the
|
|
sync.
|