djolex999

djolex999 / vir

Public

Distills Claude Code sessions into a compounding knowledge vault

11
1
80% credibility
Found May 23, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Vir is a knowledge management tool that automatically extracts valuable insights from AI coding assistant sessions and stores them as organized notes in your personal notes app. It reads your past conversations, identifies patterns, gotchas, decisions, and tool usage notes, then writes them as searchable markdown files organized by category and project. The tool runs on a schedule to process new sessions, or can be run manually, and integrates with Claude Code so future AI sessions can consult your accumulated knowledge. It uses your AI service account to analyze conversations and can optionally use local embedding models for semantic search. The knowledge flows from your AI sessions into your vault, and the most useful notes get injected back into your AI assistant's memory so it learns from past work.

How It Works

1
💬 You use an AI coding assistant

You work with an AI coding assistant that helps you build software, creating a record of every decision and solution.

2
📚 You have a notes app

You keep your project notes in an app like Obsidian where you organize everything with links and tags.

3
🌀 You install vir

You run a simple install command and vir guides you through connecting your notes app and AI service.

4
First run: your history comes alive

The first time you run it, vir reads through all your past AI conversations and pulls out the useful bits—patterns you discovered, mistakes you fixed, and decisions you made—then writes them as clean notes in your vault.

5
How you want to use it
🔄
Automatic mode

vir sits in the background and checks for new AI conversations every few hours, adding fresh insights to your vault without you thinking about it.

🎯
Manual mode

You run it whenever you want to process new conversations and refresh your knowledge.

6
🔍 You search your knowledge

Later, when you're stuck on something, you ask vir questions and it searches through your accumulated wisdom to find relevant patterns and gotchas from past projects.

7
🧠 Future sessions get smarter

vir puts the most important knowledge into your AI assistant's memory file so it starts every new conversation already knowing about your past work.

🎉 Your projects compound over time

Each new AI session adds to your knowledge vault, making every future session smarter than the last.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is vir?

Vir is a TypeScript CLI tool that automatically extracts valuable knowledge from your Claude Code sessions and deposits it into an Obsidian vault. It runs on a schedule, parses your JSONL transcripts, filters out low-signal conversations using heuristic scoring, then uses Haiku and Sonnet models to distill durable notes across four categories: patterns, gotchas, decisions, and tools. The vault feeds back into your CLAUDE.md files so future sessions start from accumulated context. An optional MCP server exposes queryable tools directly to Claude Code mid-session, and semantic search works via Ollama embeddings or TF-IDF fallback.

Why is it gaining traction?

The pitch is compelling: every Claude Code session produces useful insights that vanish into JSONL graveyard. Vir automates the capture loop without requiring you to manually write documentation. The MCP integration is the real differentiator—Claude Code can consult your vault during active sessions rather than relying on static context. The CLI is well-designed with commands for linting orphans, deduping notes, syncing CLAUDE.md blocks, and running diagnostics. Support for Kie.ai as a provider delivers roughly 72% cost savings over direct Anthropic pricing, making ongoing usage genuinely affordable.

Who should use this?

Heavy Claude Code users who want their AI assistant sessions to compound into institutional knowledge. Frontend and backend developers working across multiple projects will benefit most—vir tracks gotchas and architecture decisions per-project and surfaces them when you need them. Teams using Obsidian for documentation will appreciate the local-first approach with no third-party dependency. It's less useful for casual users or those with infrequent Claude Code sessions; the first-run cost and setup overhead only pays off if you're running dozens of sessions monthly.

Verdict

At 11 stars with experimental Linux support, vir shows promise but carries real maturity risk. The TypeScript codebase is well-structured with 30 passing tests and thoughtful features like API key scrubbing and cross-platform daemon support. Recommend trying it if you have an existing Obsidian vault and run Claude Code regularly—but run `vir doctor` after setup and expect to debug Linux quirks if that's your platform. The compounding-knowledge angle is genuinely useful if the habit sticks.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.