Quick start · Install or update · ChatGPT setup
The README walkthrough introduces the four connected parts: course map, tutor, practice and exam preparation. This guide explains how to keep a course current, use your progress, choose practice and find your saved work.
Keep one folder per course, or one ChatGPT project with the course uploads. Include lectures, exercise sheets, solutions, old exams, exam information and any other course-related material.
At the start of a study chat, select $study-os in Codex, /study-os in Claude Code or @study-os in ChatGPT. Then talk normally. You can begin with a single question, or prepare the course so later sessions can find its sources and reuse your learning records.
For example:
Prepare this course from my materials. Map the concepts and clearly outline where to find definitions and exercises.
StudyOS reads the material, builds a course index and concept map, and links concepts to definitions, prerequisites and exercises. When new materials arrive, add them to the folder or project and say, for example:
I've added lecture 5 and a corrected sheet 3. Update the course map and use the corrected sheet from now on.
The tutor uses original course passages for definitions, notation and explanations. The map helps it find those passages quickly. Your attempts show what you have learned; generated questions provide extra practice. If a passage or formula is unreadable, supply a clearer page or image when asked.
Use tutoring as an ongoing conversation while reading lectures or solving exercises. Start with what you're doing, ask questions as they arise, and share your working when you want feedback.
For example:
We're working on sheet 3, question 2. Let's work through it together.
I understand the definition but not the next step in this proof.
Here's my next step. Is my reasoning right?
The tutor reads the relevant original course material, follows its notation and cites the page or section. It explains concepts, helps you pinpoint an unclear step, gives small hints and checks your reasoning. You can use it with assigned sheets, past exams or generated practice.
Share typed steps, photos or screenshots of handwritten work. In ChatGPT, you can take a photo in the mobile app and keep solving in the same conversation. Point out the line or question you want to discuss. Using images with the tutor.
Ask for a full solution to see the complete worked answer to the exercise you are discussing. Ask for a worked example to see a sample problem demonstrate a method step by step.
As you work, the tutor records meaningful attempts, explanations covered and the help you received. Its learning summary tracks what you demonstrated, where you still need support and what to check next. For example, after solving a problem with hints, a later fresh question can check whether you can now use the method independently.
Recent attempts guide the next interaction immediately. At natural checkpoints, the tutor updates the overall summary used by later tutoring, extra practice and exam preparation. You can also bring a written solution or work done elsewhere for feedback.
Ask about your progress in ordinary language:
What can I do independently now, and what should I practise next?
Or ask “Show my concepts and progress.” You get a readable overview linking course concepts and sources to what you have demonstrated, where you need help, the next useful check and the relevant session evidence. Topics you have not tried are shown as unassessed. When you overcome a difficulty, the current view reflects the improvement while earlier attempts remain available through the links.
The saved overview lives in the existing course index and refreshes at study checkpoints and course updates. A progress question uses your latest work, including anything newer than the saved overview.
When you want to pause, tell the tutor. It gives a concise recap and saves where to resume. Wait for save confirmation before leaving or changing devices. If a save cannot finish, it tells you what remains unsaved. You can request chat-only study when you prefer to work without updating records.
Tell StudyOS what you want to practise and how much you want: a number of questions, a time limit or a particular output. It can use a topic you choose or the difficulties in your saved attempts and feedback.
For example:
Give me two new problems on what I struggled with last time.
| Ask for | What you receive |
|---|---|
| Practice problems | Fresh questions with separately saved, checked solutions and marking guidance where useful. |
| Anki cards with an import file | Front/back cards with sources and a downloadable file to import into Anki. |
| A worked example | A sample problem with the reasoning and solution shown step by step. |
| A short diagnostic | A few questions to identify what you already know and what needs practice. |
| A mock exam | A timed question paper with a separate answer key and marking guide, matching the course's exam format when available. |
Practice uses relevant original sources and your learning target. Exercise solutions stay separate until you ask for them. When you share an attempt, the tutor checks your reasoning and helps with the next correction. Your attempts and feedback guide the next round of practice.
For example, ask:
Make five Anki cards for these definitions and give me the import file.
If you already have cards, say “Export these cards for Anki.” You receive a tab-separated .txt file containing front, back and tags, ready for Anki's Basic note type. Source references appear with the answers.
- Review the cards and download or locate the export.
- In Anki, choose File → Import and select the
.txtfile. - Choose your deck and the Basic note type. Check the preview: Front, Back, Tags; separator Tab; HTML disabled.
- Import, then check a mathematical card if the export includes equations.
This file workflow works with Codex, Claude Code and ChatGPT. Reviews and review history stay in Anki. When importing revised cards, check the import dialog's update settings: matching front text can update an existing note, while changed front text can create a new one. Anki's import guide.
Give StudyOS the exam date, your goal and specific study windows. Add official scope, exam format, permitted aids and past papers when available. For example:
My exam is on [date]. I can study [specific windows], and my goal is [goal]. Use my course materials and progress to prioritize the concepts I need most. Make a realistic plan and start the first task.
The plan brings together:
- Course requirements: current official scope and relevant prerequisites.
- Exam evidence: concepts and question styles found in actual past papers.
- Your progress: demonstrated strengths, difficulties and the help you needed.
- Available time: what you can realistically improve before the exam.
StudyOS explains the priorities, chooses existing exercises or generates fresh practice, and saves the plan. It may begin with a few questions where your current understanding is unclear. Predictions about likely topics are qualified by the available evidence.
Practice starts with tasks you can learn to solve in the time available, including simpler examples when a prerequisite is blocking you. Mixed questions and full timed papers follow when you are ready and have time to review mistakes. Study blocks include checking, breaks and buffer; when time is short, the plan narrows coverage while preserving correction and a brief check of what you can do on your own.
Tell the tutor roughly how many minutes you worked and when you took a break. It records those reports and uses them to adjust the plan.
Continue in ordinary language, for example:
Continue exam prep. I have 45 minutes today.
I missed yesterday. These are my remaining study windows: …
Here is my mock-exam attempt. Mark it, explain the key gaps, and update what I should do next.
Your attempts and changes to your availability guide the next tasks and update the saved plan.
For local agents, the default is a study/ directory inside your course folder—for example, ProbML/study/:
| Record | What it contains |
|---|---|
study/index.md |
Course entry point, concept progress overview and links to its records. |
study/concepts.json |
Concepts, prerequisites, exercises and original source locations. |
study/learner.json |
Your current learning summary. |
study/sessions/<id>.json |
Attempts, help received and next checks. |
study/feedback/<id>.md |
Readable session feedback. |
study/practice/<id>/questions.md |
Generated practice, a diagnostic or an exam paper. |
study/practice/<id>/solutions.md |
Separate checked answers and marking guidance. |
study/exam-plan.md |
Current priorities, study windows and next activities. |
Cards and their Anki import files are saved under study/materials/<set-id>/. Ask the tutor to show a record or its location whenever you want to inspect it.
ChatGPT saves the same kinds of records in Library, linked through the course index. Continuing in ChatGPT.
Start a chat in the same course folder or ChatGPT project, select StudyOS, and say “Continue where we left off.” It reads the course index, learning summary and latest relevant session to resume the unfinished work. During exam preparation it also reads the current plan and checks remaining availability.
To continue with another agent, give it access to the course materials and saved records. If more than one course or session could match, StudyOS asks which one you mean.