Repolode
Submit
madhvantyagi

madhvantyagi/Gnos

A teaching harness for coding agents that plans a course around you, builds lessons, and adapts exercises from your recorded progress.

View on GitHub
Stars
342
Forks
25
Open issues
1
Last commit
yesterday

What is it?

GNOS turns a coding agent such as Codex, Claude Code, or Cursor into a teacher. You state a topic, how deep you want to go, and how much time you have. It uses course materials like syllabi, textbooks, and documentation to plan a route, then builds the first lesson with subagents that produce the lesson blocks.

While you work, GNOS records what you attempted, where your reasoning broke down, and which tasks you completed without help. It uses that record to adjust later lessons and exercises, and keeps the course plan and learner records together across sessions. Subject-specific teachers are guided by SOUL.md files that shape their explanations.

Lessons are not limited to text. GNOS can produce diagrams, images, simulations, narrated videos, or PDF handouts, and a course viewer renders the curriculum in a browser. Diagram and media features depend on the tools installed in your environment.

Key features

  • 01Plans a course route from your goal, depth, and available time.
  • 02Builds lessons from syllabi, textbooks, and documentation.
  • 03Tracks what you tried and whether you solved tasks independently.
  • 04Adjusts upcoming lessons and exercises based on learner records.
  • 05Generates diagrams, images, simulations, narrated videos, and PDFs.
  • 06Renders the curriculum and lessons in a browser study page.

Use cases

  • Learning an unfamiliar technical subject with a structured, multi-session course.
  • Building a study plan from a university syllabus or a set of textbooks.
  • Practicing a topic with exercises that adapt to where you get stuck.
  • Turning hard concepts into visual simulations or narrated lesson videos.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/madhvantyagi/Gnos.git
  2. 2

    Enter the project folder

    cd Gnos
  3. 3

    Install the Codex plugin (Codex users)

    codex plugin marketplace add madhvantyagi/Gnos --ref main
  4. 4

    Launch Claude Code with the plugin (Claude Code users)

    claude --plugin-dir .

Things to know

  • Requires a coding agent such as Codex, Claude Code, Cursor, or OpenCode with local file and terminal access.
  • Visual tools and PDF or video lessons need extra dependencies, and Pinepaper needs Node.js/npm.
  • The project is young, with 342 stars and no stated stability guarantees.

Topics

#education#llm#ai-agents#learning#curriculum#claude-code#codex#python

FAQ

What is Gnos?
A teaching harness for coding agents that plans a course around you, builds lessons, and adapts exercises from your recorded progress. GNOS turns a coding agent such as Codex, Claude Code, or Cursor into a teacher. You state a topic, how deep you want to go, and how much time you have. It uses course materials like syllabi, textbooks, and documentation to plan a route, then builds the first lesson with subagents that produce the lesson blocks.
Is Gnos free to use? What license does it have?
Gnos is open source under the MIT license. Check the license terms before using it in commercial products.
Is Gnos still maintained?
Actively maintained. The last commit to Gnos was on Oct 19, 2026.
What can I use Gnos for?
Learning an unfamiliar technical subject with a structured, multi-session course. Building a study plan from a university syllabus or a set of textbooks. Practicing a topic with exercises that adapt to where you get stuck. Turning hard concepts into visual simulations or narrated lesson videos.
How do I install Gnos?
Clone the repository: git clone https://github.com/madhvantyagi/Gnos.git Enter the project folder: cd Gnos Install the Codex plugin (Codex users): codex plugin marketplace add madhvantyagi/Gnos --ref main Launch Claude Code with the plugin (Claude Code users): claude --plugin-dir .
Where can I get Gnos?
The source code and installation instructions are on GitHub: https://github.com/madhvantyagi/Gnos

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects