gitwtfhub

wtf is pensiever?

matskoan/pensiever — explained in plain English

Analysis updated 2026-05-18

3Audience · generalComplexity · 2/5Setup · easy

TL;DR

A starter kit that lets an AI agent manage your personal notes as plain markdown files in a git repo, so you own your memory while renting the intelligence.

Mindmap

mindmap
  root((Pensiever))
    What it does
      Classifies notes
      Files and links them
      Answers questions later
    Tech stack
      Markdown
      Git
    Use cases
      Personal notes
      Decision log
      Research capture
    Audience
      Solo users
      AI agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Keep a personal knowledge base of notes, ideas, and decisions in plain markdown files.

REASON 2

Have an AI agent automatically classify, file, and link your raw thoughts.

REASON 3

Track research, tasks, and decisions with an append only log you can audit.

REASON 4

Run scheduled jobs like morning briefs or nightly cleanups to keep notes organized.

What's in the stack?

MarkdownGit

How it stacks up

matskoan/pensiever000madz000/payload-test-api-route-handler0marildo/imago
Stars333
LanguageTypeScriptPython
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires an AI agent like Claude Code or Cursor to run the setup interview.

Wtf does this do

Pensiever is a starter kit for building a personal knowledge system that an AI agent runs for you. Instead of using a note taking app, you keep everything as plain markdown files inside a git repository, and an AI agent such as Claude Code, Cursor, or GitHub Copilot reads your raw thoughts, classifies them, files them, links them together, and later helps you reason over what you have written. The idea behind the project is that you should own your memory while renting the intelligence that manages it. Your notes stay as ordinary files you control, so if a newer or better AI agent comes along, you can point it at the same folder and keep going. The main cost of switching agents is teaching the new one your conventions, which the kit stores as skill and instruction files. The system is organized around a master index file that the agent checks first before searching, which keeps things simple for a personal vault with hundreds or a few thousand notes rather than needing a database. Original source documents you capture, like clips or transcripts, are never edited by the agent, only summarized and linked. Every new file gets added to the index and connected with links so nothing is left orphaned. Important decisions are recorded in an append only log so you can see why choices were made over time. The kit is honest about its limits. It is meant for one person's use, not a team or a large scale search engine. The agent can make mistakes such as misfiling a note, so you are expected to review its work, and git history lets you undo anything. There is no polished mobile app, capture happens through plain text or voice notes. To get started, you clone the repository, open it in a supported AI agent, and tell it to set you up. It will ask a short set of questions about your name, your main areas of focus, and which tools you use, then create your personal files.

Yoink these prompts

Prompt 1
Set me up with Pensiever using my name, my main work streams, and Claude Code.
Prompt 2
Capture this raw thought into my Pensiever vault and file it correctly.
Prompt 3
Run the reflect skill in Pensiever and summarize what's stale in my vault.
Prompt 4
Show me what's in my inbox in Pensiever right now.

Frequently asked questions

wtf is pensiever?

A starter kit that lets an AI agent manage your personal notes as plain markdown files in a git repo, so you own your memory while renting the intelligence.

How hard is pensiever to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is pensiever for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.