Full documentation

Clunii — How it Works

Everything you need to know to get the most out of Clunii — from creating your first set to learning it for good with spaced repetition, Clorbi and your study group.

Getting Started

Clunii is an AI-powered flashcard app built around spaced repetition. You build sets of cards — by hand, from your notes, from a file or link, or live from a lecture — study them in several modes, and Clunii schedules each card so you spend your time on what you are about to forget.

Creating an account

Sign up with an email address, a username and a password. You'll receive a 6-digit code by email — enter it to verify your account, then accept the Terms to get started.

Every new account comes with an example set — [Example] Human Anatomy — Cardiovascular System — with 12 cards and a note that uses headings, images, bullet lists, a code block and a quote, so you can see what a finished set looks like before building your own.

The app tour

On your first login an interactive tour highlights the main parts of the app and waits for your clicks before moving on. You can skip it at any time and replay it later from Settings → Replay app tour.

Language

Clunii is available in English and German. Switch under Settings → Language.

Finding your way around

  • Home — your dashboard (see below).
  • Study — your active learning sets with their next review, your study groups and all your sets. Drag one set onto another to start a study group, or onto a group to add it.
  • Notes — all your notes, with or without a set.
  • Explore — public sets from the community.
  • Groups — your study groups and invites.
  • Settings — profile, plan, language, theme and data.

Dashboard

  • Today — how many sets are ready for review, with a button to review them.
  • Streak and a Next 7 days forecast of cards coming due, including upcoming tests from your study groups.
  • Jump back in — your sets, with the ones due for review marked.
  • Insights — how many of your cards are in each recall stage (New, Learning, Reviewing, Strong, Mastered) and your memory retention. Click Review across all sets to study every card of one stage at once.
  • Sets you haven't reviewed in 30 days are listed separately so you can keep them or take them out of active recall (your mastery is kept).
  • Ask Clorbi — the round orb answers questions about your active sets and your progress, and can take you straight to the right page (see Clorbi).

Opening a shared set without an account

If someone sends you a link to a public set, you can open it without logging in: study it and even edit it. Your edits stay on your device until you create a free account, and then they're saved to your own copy of the set. Guests can try a few AI actions before signing up.

Flashcard Sets

A set is a named collection of flashcards. Study modes, progress, the concept map and notes all belong to a set.

Creating a set

Click New set, give it a title and an optional description. New sets are private. Once a set has cards, Clunii tags it with subject categories automatically.

Visibility

  • Private — only you can see the set.
  • Group only — you and the members of the study groups it's added to. It never appears on Explore.
  • Public — anyone can find and study it on Explore, and anyone with the link can open it.

Change it on the set's Edit page.

Cards

Each card has a term (the prompt) and a definition (the answer). On the set page you can:

  • Add a card with + Add card, and edit any card in place. Leave the definition empty and let AI fill it.
  • Drag cards to reorder them.
  • Add an image to a card — search Unsplash, Pixabay or Wikimedia Commons and pick one. It is shown on the card while you study.
  • Turn a card into a multi-dimensional card with Multi: instead of one answer it has several labelled dimensions (for example Definition and Example), each studied on its own.

Editing a set

Click Edit on the set page to change the title, description and visibility and to work through all cards at once: insert cards anywhere, remove them (with undo) and make cards multi-dimensional. Changes apply when you click Save changes.

Compress on the Edit page lets AI remove duplicate cards and merge redundant ones. Choose Compress + group into multi-dimensional to also merge cards that share a base term — like "Waterfall: Requirements" and "Waterfall: Integration" — into one card with several dimensions.

Saving a copy of someone else's set

On a public set, click Save a copy (or Copy on Explore) to copy the set and its cards into your account. The copy is private, fully independent of the original and shows who it was copied from. The author earns a star.

Reporting a set

If a set contains illegal content, infringes copyright or is harassing, click Report on the set page and choose a reason. We review every report and email you what we decided. A set removed after a report can't be shared again.

Deleting a set

You can delete a set from its page. This permanently removes the set, its cards and your study progress on it, and can't be undone. Notes attached to the set are kept — they move to Notes without a set.

Create (Studio)

Studio is the workspace for filling a set with cards. Open it with the Create tile on the set page. Cards you add are saved to the set straight away and appear in the list below, where you can search them, open one to edit it or delete it.

Creation modes

  • Flip (Alt+1) — type the term on the front, press Tab to flip to the answer, or press ⌘↵ / Ctrl+↵ to let AI fill it. Switch between One answer and Dimensions, reuse the dimensions of the last card, or save them as a template. The card is added as soon as the AI is done, so you can keep typing the next one.
  • Templates (Alt+2) — start from a template: Term & definition, Definition + example or one of your own, and let AI fill the empty fields.
  • From notes (Alt+3) — pick blocks from the set's notes (click to select, Shift-click for a range) or use the whole note, and Clorbi suggests cards. Flip through them, keep or skip each one, group several into one multi-dimensional card, and add the ones you want. Cards already in the set are marked.

Clorbi in Studio

Click the Clorbi orb at the side of Studio to make cards from almost anything: drop in a PDF, a text, Markdown or CSV file, an image, paste a link, or just describe the cards you want, then click Make cards (⌘↵). For large inputs Clorbi tells you roughly how many AI units it will use and asks before going ahead.

AI-generated cards can contain mistakes. Check them before you rely on them.

Clorbi

Clorbi is Clunii's AI. You'll meet it in three places:

  • Making cards — in Studio, from files, images, links, text, your notes or a short description (see Create), and live during a lecture (see Lecture Mode).
  • Studying with Clorbi — a test session where Clorbi chooses the cards, question types and order based on how well you know each card (see Study Modes).
  • Ask Clorbi — the orb on your dashboard. Ask what to study next, ask about the content of your active sets, or ask it to open a set or a study mode, and it takes you there. It answers about the sets in active learning; for other sets it tells you how to activate them.

Every Clorbi feature uses AI units from your plan (see Plans & AI usage).

Study Modes

Every set offers Flashcards, Recall, Test (including studying with Clorbi) and Flash Quiz, next to the Concept Map and Lecture tiles. Each answer feeds the spaced repetition schedule.

Flashcards

Starts straight away with every card in the set: cards you haven't reviewed today come first, then the rest, mixing cards you remember least with ones you know well. Tap the card to flip it. Then tap its right side if you knew it, its left side if you didn't, or the middle to flip it back. The arrows under the card go to the previous or next card; moving on without answering skips the card.

  • Keyboard: Space flips, 2 knew it, 1 didn't, ← / → move between cards.
  • At the end, Practice N missed reopens Flashcards with only the cards you got wrong or skipped.

Recall

Write (or speak) what you remember, check it against the card, then rate how it went: Didn't remember, Hard, Good or Easy. New cards, and cards whose memory is still short, are shown as multiple choice instead, with answers taken from similar cards.

  • Use the microphone button to dictate your answer, in browsers that support it (Chrome, Edge and Safari). In Chrome the browser's speech service processes the audio; Clunii only receives the text.
  • Explain this card — get a short AI explanation of why the card is true or how it works, with an example or a memory hook, in your app language. Explanations are saved per card, so asking again is instant and free until the card is edited.

Test

On the Test start screen, choose which cards to use — All cards, Left today (not reviewed today and not waiting for review) or Needs review — how many, and which question types:

  • Multiple Choice — pick the right answer from four options.
  • True / False — decide whether a statement is correct.
  • Written — type your answer. AI grades it for meaning, not exact wording, marks it correct, partially correct or incorrect, and explains why.
  • Fill in the Blank — complete the missing word or phrase.

Questions are written by AI and saved, so the next test on the same cards can reuse them for free — click Get new questions for fresh ones. When you're out of AI units, tests still run with standard questions. The results screen shows your score and lets you practise the cards you missed.

Studying with Clorbi

Select the Clorbi card on the Test start screen and Clorbi builds the session for you. It moves each card up a ladder of four levels — Recognise, Tell apart, Fill in and Recall — as you get it right, and back down when you don't, and shows how each card moved at the end. You need to be signed in, because Clorbi uses your study history.

Flash Quiz

Starts straight away with a round of 5 multiple-choice questions, taken from cards you haven't studied yet today (topped up with other cards if fewer than 5 are left). Click Next round to keep going. Great when you only have a few minutes.

On the Free plan you can start one Test or Clorbi session per day. Flashcards, Recall and Flash Quiz are unlimited on every plan.

Mix-ups

When a wrong answer shows that you confused two cards — for example you picked or typed another card's answer — Clunii shows Mix-up detected and comes back to that pair a few questions later: it puts the two cards side by side, highlights what tells them apart, and asks two quick "which term is this?" questions. Later it checks the pair again on a following day until you reliably tell them apart.

  • Mix-ups are caught in Test (multiple choice, written and fill in the blank), Flash Quiz and Clorbi sessions, and drills and checks also appear in Recall.
  • Drills and checks are not scored and don't count towards the session length. Clunii places them for you — there's nothing to start or skip.
  • On the concept map, the Confusions toggle draws the pairs you mix up as red dashed lines; click one to compare the two cards.

Concept Maps

A concept map shows how the ideas in a set connect. Every card is a node labelled with its term, and lines between nodes show relationships, each with an optional short label. Open it from the set's Concept Map tile.

Generating the map

The map is built by AI from your cards. A set without a map shows Generate concept map; once it has one, Auto-connect lets Clorbi connect your cards again — useful after adding a batch of new ones. A set needs cards before it can have a map.

Navigating the canvas

  • Drag any node to reposition it — positions are saved automatically.
  • Auto-arrange re-runs the layout to remove overlapping nodes.
  • Pan by dragging an empty area; zoom with your scroll wheel or trackpad or the on-screen controls.
  • Use the search box to highlight matching nodes and dim the rest.
  • Mastery colours each concept by how well you know it: Mastered, Learning or Needs work.

Editing from the map

Click a node to open its details: term, definition and its connections — click a connection to jump to that node. Use Edit card to change the term or definition; saving updates the flashcard. Add concept creates a new card right from the map.

Connections

  • Connect — click two nodes (or drag from one to another) to connect them. Click a line in Connect mode to remove it.
  • Outside Connect mode, click a line to add or edit its label.
  • Cards that aren't linked yet sit in the "Unlinked" panel. Drag one onto the map to place it, or drag a placed node back to unplace it.

Lecture Mode

Lecture mode turns what is said in a lecture into flashcards while you take notes. Open it with the set's Lecture tile, choose the lecture language (English or German) and press Listen.

  • The concepts being taught appear as the lecture goes on. Click a concept to have Clorbi write its card, or write your own cards next to the suggestions.
  • Your notes for the set open next to the cards; switch between split, cards-only and notes-only layouts.
  • Use Pause during questions and discussions — nothing is recorded while paused. Press Stop at the end, edit your draft cards and click Add N to set. Cards already in the set are skipped.

Only record with your lecturer's permission and where your university allows it. Before each session Clunii asks you to confirm this, and can give you a short message to send your lecturer. Don't use Lecture mode in seminars or group discussions. The audio is used only to create your cards: Clunii doesn't keep it, and our transcription provider deletes it within 48 hours.

Lecture time depends on your plan: a one-time 10-minute trial on Free, 3 hours a month on Plus, 10 hours on Premium, and billed per hour on Pay as you go.

Spaced Repetition

Clunii schedules your reviews with spaced repetition: when you remember a card, you see it again after a longer interval; when you forget it, it comes back soon.

How scheduling works (FSRS)

By default Clunii schedules each card with FSRS, a modern open scheduling algorithm that models how well you remember a card and picks the next review for the moment you are about to forget it. Every answer becomes one of four ratings: Didn't remember, Hard, Good or Easy. You never have to work out an interval yourself.

Where the rating comes from

In Recall you rate yourself after checking your answer; a multiple-choice pick counts as Good when right and Didn't remember when wrong. Clunii doesn't grade your typed Recall answer for you.

In Flashcards you only say whether you knew the card. With FSRS on, Clunii also notes how long you looked at the front before flipping and compares it with your own usual time: a wrong answer is Didn't remember, a right answer after a long hesitation is Hard, a clearly quick one Easy, and anything else Good. Your timing only starts to count after a few dozen cards, and is ignored if you left the tab or took longer than 35 seconds.

Turning FSRS off

Under Settings → Study scheduling you can switch to simpler scheduling: each correct answer adds 20 to the card's mastery and multiplies its interval by 2.5 (up to 30 days), and a wrong answer subtracts 10 and brings the card back the next day. In Recall you then rate yourself with Missed it, Got it and Easy; in Flashcards only right or wrong is recorded. Switching only changes when cards come back — your progress is kept.

Mastery and recall stages

Every card has a mastery score from 0 to 100, starting at 0. With FSRS it reflects how long your memory of the card is predicted to last, so it rises as intervals grow and drops when you forget. Cards are grouped into the recall stages New, Learning, Reviewing, Strong and Mastered, shown on your dashboard. The set page shows the set's overall mastery and how many cards are left today.

Needs review

A card you answer wrong or skip is marked needs review (unless it's already mastered). Pick Needs review on the Test start screen to work through just those cards. The mark is cleared when you next answer the card correctly.

Active learning

Click Activate on a set page to add the set to active learning. Active sets appear on your dashboard and the Study page with their next review date and are marked "due" when it's time. Each completed session on a due day moves the next review further out:

1 day2 days3 days7 days16 days30 days

Studying before the due day doesn't move the schedule forward. A set that is more than 3 days overdue drops out of your review list — open it and study it to put it back on schedule. Mix-up checks that come due make their set due too.

Notes

Notes are your own and private — two people studying the same public set each have their own. A note can stand on its own or be attached to a set, and a set can have several notes. Find all of them under Notes in the sidebar: search, filter by set or "No set", create a note, and attach, change or detach its set. On the set page, the notes panel shows the set's notes; you can resize it, widen it or go fullscreen. Notes save automatically.

Block types

The editor is block-based. Type / to open the command menu and turn the current block into another type:

Heading 1–3
/head1 /head2 /head3

Section, sub-section and minor headings.

Bullet list
/bullet

Unordered list item.

Numbered
/num or 1.

Ordered list item. Typing “1. text” and pressing Enter also starts a numbered list.

To-do
/todo

Checkbox item. Click the checkbox to toggle.

Code block
/code

Monospace code with a language picker. Tab indents, Shift+Enter adds a line.

Quote
/quote

Block quote.

Divider
/divider

Horizontal line between sections.

Diagram
/diagram

Draw rectangles, ellipses, diamonds, arrows and text.

Color text
/color

Text in a colour of your choice.

Link
/link

Insert a link.

Image
⌘ + drag

Hold ⌘ and drag on the page to draw an image box, then search for an image or drop a file. Images can sit inline or float left or right, with a caption.

Each block also has a menu to turn it into another type, insert blocks above or below, duplicate, move or delete it.

Keyboard shortcuts

  • ⌘B bold, ⌘I italic, ⌘U underline, ⇧⌘S strikethrough, ⇧⌘H highlight, ⌘` inline code
  • ⌘K insert a link, ⇧⌘C colour the selected text
  • ⌘E explain the selected text with AI
  • ⌘Z undo, Enter new block, Backspace on an empty block deletes it
  • ↑ / ↓ move between blocks
  • On Windows and Linux use Ctrl instead of ⌘. Click Keys in the toolbar to see the full list.

AI for notes and cards

When a note is attached to a set, three buttons connect it with the set's cards:

  • AI Notes — writes study notes from your cards, with headings, paragraphs and bullet points.
  • To cards — finds flashcards in your note text. They appear in a drawer where you select which ones to add to the set.
  • Merge Cards and Notes — fills gaps in both directions: cards for topics in your notes that have no card, and notes for cards your notes don't cover.

The toolbar also offers:

  • Summarise — a shorter version of your note.
  • Explain — select text and get a plain-language explanation.
  • Tag — suggests topic tags for the note.
  • Quiz — multiple-choice questions written from your note.
  • Flash — a 5-question Flash Quiz from the set's cards (needs at least 4 cards).
  • Search and a table of contents for long notes.
  • Export — copy as Markdown, import Markdown or export as PDF.

Explore

Explore shows the public sets other users have shared — a community library of ready-made sets.

  • Search by title.
  • Each set shows its title, its author with their stars, and its number of cards. Click the author to see their profile and their other public sets.
  • Click Copy to save your own private copy of a set (see Saving a copy).
  • To share one of your sets here, set its visibility to Public on its Edit page.

Study Groups

A study group is a shared space where members study the same sets. Teachers can use one for a class; friends can use one as a shared study hub.

Creating and joining

  • Go to Groups and click Create. Give the group a name and an optional description. You become its admin. You can also start a group on the Study page by dragging one set onto another.
  • Every group has a 6-character join code. Share it, and others join with Join by code.
  • Admins can also invite people by username. They need a Clunii account, get an email with a link to the group, and can accept or reject the invite.

Sets in a group

Admins add sets — their own, an existing one or a new one created for the group. Admins can let individual members add sets without approval (Can add sets); other members can Suggest set, and an admin accepts or rejects the suggestion. A Private set added to a group becomes Group only: only you and the group's members can open it, and it never appears on Explore. Public sets stay public.

Group page

  • About, Details (instructor, meeting times, location), Study goals, Resources & links and Notes panels that admins fill in.
  • Schedule — homework, quizzes, tests, exams and projects with a due date and the sets to study. Before a test, members see which cards still need work and can study all its sets together in any mode.
  • Most confused pairs (admins) — pairs of cards that several members mix up. Counts only, no names.

Group tests

An admin can start a live test for the group from all sets or selected ones, with a number of questions and an optional time limit. Members join the lobby, the admin begins when everyone is in, and everyone answers the same cards. People without an account can join with just a name through the test's join link. Afterwards the admin sees the class score, results by set and card, and the hardest cards.

Group map

Admins can open a Group map of a set: its concept map coloured by how much of the group has learned each card or would remember it today, with the weakest cards and common mix-ups. It shows the whole group without names. Members choose whether to share their own progress with the admins, and can see exactly what admins see about them.

Leaving and removing

Members can leave a group at any time; admins can remove members. Either way, your own sets and study progress are kept. Deleting a group removes it for every member.

XP, Streaks & Stars

XP

You earn XP for every correct answer. The longer your streak, the more each answer is worth: 1 XP, 2 XP from a 2-day streak, 3 XP from 4 days and 4 XP from 7 days. Your XP total is shown in Settings.

Streaks

Your streak grows by one for each day in a row on which you study. Miss a day and it starts again from one the next time you study. Your streak is shown on the dashboard and in the sidebar.

Stars

You earn a star each time someone saves a copy of one of your sets. Stars appear next to your name on Explore, on your public profile and in Settings.

Plans & AI usage

Every plan includes flashcards, spaced repetition and all study modes. Plans differ in how much AI you can use. AI is measured in AI units: each AI action (generating cards, grading a written answer, an explanation, Ask Clorbi, notes tools, a concept map) uses some units, and your usage is shown in Settings.

  • Free — a small amount of AI each month, one Test or Clorbi session per day, and a one-time 10-minute lecture trial.
  • Pay as you go — €1.99 / month plus AI billed by what you use. You set a monthly spending cap (€5 by default) and AI pauses when you reach it. Lectures are billed per hour.
  • Plus — €4.99 / month with a monthly AI allowance and 3 hours of lectures. Nothing extra to pay.
  • Premium — €9.99 / month with the highest AI allowance (fair use) and 10 hours of lectures. Nothing extra to pay.

Allowances reset at the start of each month. Click Upgrade in Settings to choose a plan and pay securely with Stripe. Plans are billed monthly and can be cancelled at any time — you keep access until the end of the billing period.

Settings

Profile and account

  • Avatar — click your avatar to choose one from the built-in library, or reset it to your initial.
  • Username and Email — change them under Account. Both must be unique.
  • Change password.
  • Replay app tour, Beta feedback (tell us what works and what doesn't) and a link to this documentation.

Preferences

  • Appearance — Dark, Light or System (follows your operating system).
  • Language — English or German.
  • Study scheduling — turn smart scheduling (FSRS) on or off (see Spaced Repetition).

Subscription

See your plan, AI units and lecture minutes used this month, upgrade, or cancel your subscription.

Data & Privacy

  • Download my data — exports your profile, sets, cards, notes and progress as a JSON file.
  • Links to the Privacy Policy, the Impressum and the open-source licences.

Danger zone

  • Log out — signs you out on this device.
  • Delete account — schedules your account for permanent deletion after 3 months. Until then your sets are hidden from others and logging back in restores everything; after that your account, sets, cards, notes and progress are deleted for good.

Ready to start studying?

Free to start — no credit card required. Paid plans are optional.

Create your account