Documentation
Askesis docs
How studying, scheduling and everything around it work, in plain words. Start with the basics, or jump to a topic.
Get started- BasicsGetting startedWhat Askesis is, your first session, and a tour of the dashboard.What Askesis is · Your account · The dashboard
- BasicsSpaced repetition, explainedWhy reviewing at growing intervals works, what your answers tell the scheduler, and how the retention target sets your workload.The forgetting curve · Active recall · Spacing
- BasicsStudying & the four buttonsWhat each answer does, how a card moves from new to mature, and the study modes.The four buttons · A card’s life · Daily limits
- BasicsCustom study & tagsStudy exactly what you want: pick decks, then open Custom study for a mode, tags and a card count. Links can be bookmarked.The study page · Choosing decks · Study modes
- SchedulingHow scheduling worksDeck presets, the default timings, the SM-2 rules in plain words, and FSRS.Deck presets · The defaults · New and learning cards
- SchedulingManaging your workloadDaily limits, how new cards turn into reviews, catching up on a backlog, leeches, bury and suspend, and picking a retention target.Daily limits · New cards become reviews · Handling a backlog
- Your cardsWriting good cardsCards that are quick to answer and easy to remember: one fact each, precise questions, no lists, and bad → better examples.Why it matters · One fact per card · Ask a precise question
- Your cardsCard formattingMath with LaTeX, highlighted code, and light text styling on your cards.Math (LaTeX) · Code · Text styling
- Your cardsDecks, subdecks & tagsOrganize cards into nested decks, give each deck its own preset, and slice everything with tags.Decks and subdecks · Managing decks · The card browser
- Your cardsImport & exportMove cards in and out as CSV or TSV, merge decks by name, and keep full backups with progress and review history.File format · Header lines · Columns
- Your cardsMake cards with AIA copy-paste prompt that has ChatGPT, Claude or Gemini write a deck you can import, and the exact card file spec for agents and scripts (/llms.txt).Make a deck with a chat assistant · For agents and scripts · The spec
- MoreReading your statsWhat every number on the dashboard means: due counts, streak, XP, the heatmap, forecast, retention, answer buttons and more.Today · Streak and freezes · XP and level
- MoreXP, levels & streaksHow XP and coins are earned, the rank ladder, streaks and freezes, the daily chest, quests, lucky finds and trophies.XP · Levels and ranks · Streaks and freezes
- MoreLevels, XP and ranksHow you earn XP in Askesis, how much each level takes, the ten ranks from Spark to Engram, and how your streak boosts XP.What are levels? · How to earn XP · XP needed per level
- MoreThe daily chestWhat the daily chest is, how to open it, what each chest tier holds, and how the weekly chest and its streak freeze work.What is the daily chest? · How to open it · Chest tiers
- MoreDaily questsThe six small goals you get each day: which quests exist, how targets are chosen, how to claim rewards and the all-quests bonus.What are daily quests? · The quests · How targets are chosen
- MoreReminders & installing the appInstall Askesis on your phone or desktop and get one nudge a day, at the hour you choose.Install the app · Daily reminders · Troubleshooting
- MoreSelf-hosting & configurationRun Askesis yourself: setup, environment variables and push reminders.Run it locally · Environment variables · Push reminders