οὐθείς Agenda — Guide
What it is
οὐθείς Agenda is an open and lightweight planning journal: appointments, tasks and notes in one list, on all your devices, kept confidential by its design rather than by a promise.
- Confidential by design. The server keeps exactly one file per journal, and that file is encrypted end to end. The key is derived from the eight words of the journal and never leaves your devices, so the server knows nothing about the content and needs to know nothing (zero knowledge). Everything that gives access lies with you, in your app.
- Cross-device. Every device with the eight words of your account shows the same journal; changes are synchronised through the server.
- Sharing is your own agreement. Whether you share a journal, and with whom, is settled between the people involved: whoever gets the words of a journal can use it. No platform has to support it, and nobody has to be invited through an account of some provider.
- Across platforms. Sharing calendars between people on different systems usually takes a lot of effort and does not scale. A shared journal works the same in every browser, on every operating system.
- Compatible. Calendar files (
.ics, iCal) can be imported and exported, so appointments can be taken over from other calendars and handed back to them.
This guide explains how to use the agenda. The technical background is in the architecture; this page covers what you need to know to work with it.
Entries
An entry is one line: text first, tags after it.
Call the plumber #facet-home #date-2026-11-20 #time-08:00
You do not have to type tags. Write or dictate the text in the field at the top and tap Add. If the line has no facet, the app asks for one. Everything else can be added later with the + next to an entry's tags.
Notes. An entry can carry a note of up to 500 characters, such as an address, a phone number or an agenda: the note button next to the + opens a text field; Save attaches the note, an empty field removes it. The list then shows a small document icon after the entry's text; tapping it opens the note. In the line, the note stands in double braces before the tags: Meet the client {{Address: Garden Square 3}} #facet-work. Calendar descriptions become notes when you import a calendar file.
| Tag | Meaning | Examples |
|---|---|---|
#facet-… |
area of life or work; every entry has one, at most three (the first decides the journal and the colour; add more with + → another facet) |
#facet-work, #facet-ofc #facet-school |
#date-… |
the day from which the entry appears; two dates make a span | #date-2026-11-20 |
#time-… |
a time, a span or a duration | #time-08:00, #time-09:00-15:00, #time-45m, #time-1h30m |
#recurring-… |
repetition | #recurring-daily, #recurring-tue-thu, #recurring-monthly-1-15 |
#rank-… |
importance | high, medium, low |
#size-… |
effort | s, m, l |
#action-… |
state | required, now, waiting, idle |
#topic-… |
subject; words may be joined by hyphens | #topic-taxes, #topic-open-day |
#done-… |
closed on this day | #done-2026-11-20 |
A new account starts with the facets private and work and the topics sports, official and travel, each kept by a Tag definition (see below), and with a few example entries. Settings → Example tags and entries removes them with Delete or keeps them with Keep; if your own entries already use these tags, you choose for each whether it keeps the tag, moves to another facet or topic (a new one can be created there), or is deleted. Facets and topics are not configured anywhere else. A value exists as soon as an entry uses it, and it disappears when no entry has used it for longer than the retention period (90 days after an entry is closed).
Working with the list
- Swipe right on an entry: mark it done or defer it (tomorrow, 3 days, 1 or 2 weeks, 1 or 3 months).
- Search: the magnifier at the top (or
/on a computer) searches text, notes and tags of all journals, also beyond the next 30 days; include done finds closed entries as well. - Date of a new entry: set it in the facet choice that opens after Add (calendar and clock buttons); without it, the entry is for today. In the tag menu,
dateandtimehave calendar and clock buttons (from, to). - Tap the text to change it; tap a tag to change or remove it;
+adds a tag. For values without a fixed list (facet, topic, date, time, recurrence) the field at the top of the menu shows the complete tag, e.g.#topic-, and you type only the value. - Groups: Today (with overdue entries), Tomorrow, Next 7 days, Later (up to 30 days). Each group shows a limited number of entries; more shows the rest. Entries with a clock time are always shown.
- Text shows the working copy as plain text, one entry per line. Manual edit makes it editable like a text file: change lines in place, add lines, select everything and copy it. To delete lines, tick their boxes on the left and press Delete. Nothing is written until you tap Save; Review lists what you changed, and lines that cannot be read (an impossible date, a missing facet) are listed and must be corrected first. Dismiss discards your changes.
Filter
- The facet bar below the input field shows every facet with its number of entries. Tap a facet to hide or show it; press and hold to show only this facet; All shows all facets again, None hides all of them, so that you can switch on single ones.
- The filter tab (funnel) covers the other tags: topic, action, rank, size, time, recurrence. Tap to hide or show a value, press and hold to show only this value. The result appears in the list, with a line naming the filter and a Reset button. Reset clears these filters; the facet selection stays.
Keeping values: Tag definitions
A facet or topic disappears when it is no longer used. To keep it, add an entry that starts with Tag definition: and is dated 31 December 3000:
Tag definition: annual tax return #date-3000-12-31 #topic-taxes
Tag definition: family appointments #facet-family #date-3000-12-31
When you create a facet or topic in the field for a new value (with the prefix #facet- or #topic-), the app writes this line for you. With several journals it asks which journal a new facet belongs to, and in which journals a new topic is kept. The ? next to the field summarises this. Such entries never appear in the list, because the list ends three months ahead; they stay in the journal and can be edited in the Text view. The text after the colon describes what the value stands for; a language model that sorts new entries can use it. Tag definitions need no facet.
A Tag definition with a facet also decides which journal that facet belongs to (see Sharing a journal).
Your account
The account is a phrase of eight words, shown once when the account is created. Write it down. It is the only key to your journal: the server stores only encrypted lines and cannot read them, and nobody can restore a lost phrase.
- Whoever has the phrase can read and change the journal. Do not pass it on except for a journal you share on purpose.
- Settings → Account ID is a code you can give to the operator of the server to find your file. It does not give access to anything.
- Export journal file downloads the encrypted file; with the phrase it can be opened in any browser with Open local journal, without a server. The plain-text export is readable by anyone who gets the file.
Sharing a journal
Several people can share a journal, for example for family appointments. A shared journal is an account of its own with its own phrase; everyone who shares it adds it in their app. Your own journal stays private.
- One person opens Settings → + Add journal, taps Create a new journal, gives it a name and writes down the eight words.
- The others open Settings → + Add journal, enter the same eight words and tap Add.
- Someone declares the facet that belongs to the shared journal, with a Tag definition in that journal (in the Text view, choose the journal first):
Tag definition: family appointments #facet-family #date-3000-12-31
From then on, in every app that has the shared journal:
- Wherever you choose a facet, each one carries the name of its journal in small letters (family · Familie). Choosing family · Familie writes the entry to the shared journal. Several journals may have a facet of the same name (three children with
sportseach); they are different facets. - If you type
#facet-familyyourself, the entry goes to the shared journal only after you confirm it; a facet of one of your own journals needs no confirmation. In the list, hovering over a facet shows its journal. - The list shows the entries of all your journals together. Entries from a shared journal carry its name.
- To move an entry to another journal, tap its facet and choose the facet with the other journal's name; the current facet is also offered in every journal that does not have it yet (new here). Undo takes it back. Nothing is ever moved without your choice.
Your journals on all your devices
The journals you add belong to your account: add one on your phone, and your other devices show it after their next sync. Remove from my journals removes it from all your devices; the journal itself stays on the server for the others.
Only the person who created a journal is offered Delete on server. If the owner deletes a shared journal, your app says so and keeps its last state, so you can still export it; then remove it.
Who uses a journal
Edit shows under Used by how many people have used the journal recently: you, and how many others. The server recognises people by an ID that is different for every journal and does not tell who they are; all your devices count as one. It is a guide, not proof.
Your own tags on shared entries
On an entry of another journal, + → another facet or another topic adds a tag only you see, for example family on your children's school and music entries. It is kept in your own journal; the others' journal is not changed. Such tags have a dashed border. If the entry is closed or removed, your tag goes with it.
Preparations and references
+ → reference to an entry links an entry to another one, for example "Find the sheet music" to the music lesson it belongs to. The chip shows the other entry's text; tapping it offers to go there.
Stop sharing
Settings → Journals → Edit → Stop sharing for anybody (only for a journal you created) ends sharing for everyone at once. Behind the scenes, the app moves the journal's content into a newly created journal with new words, puts the new journal on all your devices and deletes the old one on the server. The others see the old journal as deleted by its owner; what they have already seen stays in their browser. To go on sharing with some of them, give them the new words or the QR code again.
Passing the words by QR code
Instead of reading out the eight words: open Settings → Journals → Edit → Show QR code on one phone, and on the other + Add journal → Scan QR code. The app reads the code itself; the words do not go through a link, the browser history or the server. On a computer without camera, type the words.
The journal's name
A journal names itself with an entry like this:
Journal name: Familie #date-3000-12-31
Everyone who shares the journal sees the same name. Settings → Journals → Edit changes it. For a journal someone else created you can also set an alias there: it is shown only to you, on all your devices, and does not change the name the others see. When you add an existing journal, the name you type becomes your alias. A journal without such an entry is shown with the first four characters of its account ID.
Two journals, one facet name
Two people may well choose the same facet name, for example familie in their own journal and in the shared one. The app keeps them apart: wherever the name occurs in more than one journal, the journal's name follows it (familie · Familie), each has its own colour and can be filtered on its own, and when you add an entry with that facet, the app asks which one you mean. The journals themselves keep the plain name.
If you want to change a name anyway, Settings → Rename tag renames a facet or topic across the journals you choose (all of them unless you leave some out): choose the value and the new name; the preview tells you per journal how many entries change. Tag definitions are renamed with the entries. If the new name already exists in a journal, both values are merged there.
If entries with a facet that another journal declares are still in your own journal, a notice offers to move them there, or to keep them where they are.
Repeating entries with two dates
A repeating entry with two dates is read in one of two ways, depending on how far apart the dates are:
- Closer than one repetition: one occurrence over several days that repeats.
Summer festival #date-2026-07-10 #date-2026-07-12 #recurring-yearlyis every year from 10 to 12 July. - Otherwise: the start and end of the series.
Training #date-2026-11-16 #date-2027-03-31 #time-12:00-13:00 #recurring-mon-wedis Mondays and Wednesdays from 12 to 13 o'clock, until 31 March.
Weekday lists such as mon-wed and daily always mean start and end of the series. The list shows how an entry is read, and marks cases that look unintended with check dates.
Date and time of a new entry
Type the entry and tap Add. When you then choose its facet, the calendar and clock buttons at the top right of that dialog set its date and time (from, to). Without a date, the entry is for today. You can also type the tags yourself, for example #date-2026-11-27 #time-09:30-10:15.
Calendar files
The agenda can be the one place for appointments from all your calendars.
- Import: Import entries → Choose files accepts one or several
.icsfiles (for example invitations you received, or an export of your work or private calendar); you can also paste the content of a calendar file. In the preview you choose the facet, for all events or one by one. Importing the same file again later updates the entries instead of duplicating them; their facet stays as you set it. Repetitions that the agenda cannot express (every second week, for example) are imported once and marked for review. - Export: Settings → Export calendar writes the open items of the facets you choose, for 30 days, 3 months or all, into one
.icsfile that Outlook, Apple Calendar, Google Calendar or Proton can import. This file is not encrypted.
Printing
Settings → Print agenda prints the next 30 days on one A4 page as a checklist with room for notes, for the facets you select (preselected from the facet bar). Each line carries a short reference to the entry.
Without network
The app keeps a copy of your journals in the browser and works offline. Changes are sent when the server is reachable again. in sync in the header shows that everything has been sent.