GitHub - yigengjiang/axiomind: Axiomind is an agent-maintained personal cognition system that compiles daily notes into axioms, principles, and an Obsidian-compatible Markdown wiki. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
yigengjiang
axiomind
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>1 Commit<br>1 Commit
assets
assets
LICENSE
LICENSE
README.md
README.md
axiomind.md
axiomind.md
View all files
Repository files navigation
Axiomind
Axiomind is a lightweight protocol for turning messy daily notes into an agent-maintained personal cognition system.
It is not a note-taking app, a RAG pipeline, or another folder template. It is a copy-pasteable Markdown protocol that tells an LLM coding agent how to compile your journals into an Obsidian-compatible brain/ made of observations, principles, axioms, areas, projects, resources, MOCs, and an audit log.
Early demo: a real Axiomind brain has been successfully rendered in Obsidian Graph View: assets/axiomind-ob-graph-view.png.
The core idea
Most personal knowledge systems help you store notes. Axiomind helps you consolidate them.
Daily notes are noisy: repeated templates, todos, mood logs, links, half-formed ideas, project updates, and occasional deep insights. Axiomind treats those files as raw sources, then asks an LLM agent to incrementally build a structured cognition layer on top of them.
daily-notes/ # raw source, never modified<br>↓ ingest<br>brain/inbox/observations/ # daily extracted observations, auditable<br>↓ weekly reflect + human review<br>brain/{axioms,principles,areas,projects,resources}/<br>agent-readable personal context
The key artifact is not the chat history. The key artifact is the maintained Markdown brain/.
What Axiomind produces
A typical Axiomind brain looks like this:
brain/<br>├── brain.md # top-level MOC<br>├── log.md # chronological audit log<br>├── axioms/ # what you default to believing<br>│ └── axioms.md # semantic MOC<br>├── principles/ # reusable action rules<br>│ └── principles.md<br>├── areas/ # long-lived life/work domains<br>│ └── areas.md<br>├── projects/ # active project state<br>│ └── projects.md<br>├── resources/ # external references<br>│ └── resources.md<br>└── inbox/<br>├── observations/ # daily ingest outputs<br>└── proposals/ # items requiring human review
The taxonomy is intentionally small:
Observation : an auditable extraction from one day of notes.
Principle : a reusable way of acting in recurring situations.
Axiom : a deeper belief that can generate many principles.
Area : a long-lived domain such as health, learning, career, communication, or creation.
Project : an active effort with current state and next steps.
Resource : an external article, paper, tool, link, or source.
MOC : a semantic map-of-content file used for navigation instead of generic index.md files.
How to use it
Put your raw notes somewhere, for example:
daily-notes/YYYY/MM/weekN/MM-DD/record.md<br>daily-notes/YYYY/MM/weekN/MM-DD/reflection.md
Copy axiomind.md into your repo or paste it into Claude Code, Codex, Cursor, OpenCode, or another LLM coding agent.
Ask the agent to instantiate Axiomind:
Read axiomind.md and create an Axiomind brain for this notes repository.<br>Do not modify daily-notes/. Create the brain/ structure, schema, agent rules,<br>and a first ingest example for YYYY-MM-DD.
Run daily or weekly maintenance by asking the agent to:
Perform Axiomind single-day ingest for YYYY-MM-DD.
or:
Perform Axiomind weekly reflection for this week's observations.
Review candidate axioms and principles. The agent may propose them, but you decide what becomes active.
How this differs from Andrej Karpathy's llm-wiki
Axiomind is directly inspired by Andrej Karpathy's llm-wiki pattern: raw sources are compiled by an LLM into a persistent Markdown wiki instead of being rediscovered from scratch at query time.
The difference is that llm-wiki is a general pattern for maintaining a wiki over arbitrary sources, while Axiomind is a more opinionated protocol for...