← all repositories
Harlihm/Your-Self-Improving-AI-Brain

Your Obsidian Vault Hires an AI Intern

This project turns your static Obsidian notes into a working memory by giving an AI agent read-write access to your vault, where it runs tasks and writes lessons back into markdown files.

1.2k stars JavaScript AgentsLLMOps · Eval
Your-Self-Improving-AI-Brain
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

This is essentially a structured Obsidian vault template and orchestration layer. You capture ideas in an inbox, track projects, and take daily notes in plain markdown. An external CLI agent called Hermes reads those files, runs skills like inbox sorting or stale-project detection, and writes results back into your vault—including a running lessons.md file meant to make the system “self-improving” over time.

The interesting bit

The memory layer is stubbornly low-tech: no vector database, no embeddings, just markdown files on disk. The agent appends its operational lessons to a permanent file inside the vault, creating a feedback loop where the “improvement” is durable, inspectable, and survives even if the AI model behind it changes.

Key highlights

  • Uses standard Obsidian folders (inbox/, projects/, daily/, etc.) as both memory and task queue
  • Ships with five built-in skills: inbox processor, daily brief, project health, weekly review, and a “learn” skill that updates lessons.md
  • Routes AI work through OpenRouter, so you can swap models without vendor lock-in (free tier works)
  • Optional X/Twitter content module for drafting and archiving posts
  • All state lives in markdown files you already own

Caveats

  • Requires three separate moving parts to function: Obsidian, the external hermes-agent CLI, and an OpenRouter API key
  • The “self-improving” claim rests on a simple feedback loop written to a single markdown file; the README doesn’t clarify how or if the agent’s behavior materially changes over time
  • It is more of a vault skeleton and glue code than a standalone application

Verdict

Worth a look for Obsidian power users who want their notes to trigger action instead of gathering dust. Skip it if you need a fully packaged app or a model that actually retrains itself.

Frequently asked

What is Harlihm/Your-Self-Improving-AI-Brain?
This project turns your static Obsidian notes into a working memory by giving an AI agent read-write access to your vault, where it runs tasks and writes lessons back into markdown files.
Is Your-Self-Improving-AI-Brain open source?
Yes — Harlihm/Your-Self-Improving-AI-Brain is open source, released under the MIT license.
What language is Your-Self-Improving-AI-Brain written in?
Harlihm/Your-Self-Improving-AI-Brain is primarily written in JavaScript.
How popular is Your-Self-Improving-AI-Brain?
Harlihm/Your-Self-Improving-AI-Brain has 1.2k stars on GitHub.
Where can I find Your-Self-Improving-AI-Brain?
Harlihm/Your-Self-Improving-AI-Brain is on GitHub at https://github.com/Harlihm/Your-Self-Improving-AI-Brain.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.