second-brain-os

Guides and resources for AI engineers: an agents course, five handbooks, a hands-on second-brain project and a vetted reading list.

What is second-brain-os?

Guides and resources for AI engineers: an agents course, five handbooks, a hands-on second-brain project and a vetted reading list.

Overview of second-brain-os

What it is

An AI second brain that maintains itself. It is a knowledge base that an AI agent builds and maintains for you in plain markdown files you own. Everything you read, watch and save gets turned into linked wiki pages, connected to everything already there, and you can ask it questions. This repository contains the full version of the guide: concepts, setup, vault template, agent skills, scripts, and resources. It is free, no signup, nothing to install beyond Obsidian and an agent. The repo includes docs (guide, agents course, handbooks), a starter vault template, 18 agent skills, 72 slash commands, 6 subagents, Claude Code plugins, dependency-free Python scripts, resources, and examples.

Key features

  • Self-organizing knowledge base maintained by an AI agent
  • Plain markdown files, one idea per page, densely linked
  • Two layers: a wiki for what you know, projects for what you are doing
  • 18 agent skills, one per workflow in the guide
  • 72 slash commands as scoped entry points into those skills
  • 6 subagents, four of them read-only by design
  • Dependency-free Python scripts for link checking, stats and graph export

Use cases

  • Saving articles, transcripts, PDFs, chat exports, voice, and backfilling old material
  • Building a wiki that gets better as it grows rather than just bigger
  • Asking questions about your knowledge base
  • Managing projects with an Inputs / Process / Outputs / Feedback pipeline
  • Connecting live data: calendar, email, chat
  • Putting maintenance on a schedule so the vault files itself

Getting started

bash# copy the starter vault, skills, commands and agentsgit clone https://github.com/undefined-ui/second-brain-os.gitcp -r second-brain-os/vault-template ~/brainmkdir -p ~/brain/.claudecp -r second-brain-os/skills ~/brain/.claude/skillscp -r second-brain-os/commands ~/brain/.claude/commandscp -r second-brain-os/agents ~/brain/.claude/agentscp -r second-brain-os/scripts ~/brain/scripts# the folder READMEs are for reading on GitHub, not for the agentrm ~/brain/.claude/*/README.md ~/brain/scripts/README.mdcd ~/brain && claudeThen install Obsidian and open the ~/brain folder as a vault. Set up Claude Code. Optionally connect over MCP. Get interviewed for your CLAUDE.md. Set up the two layers. Scope down to one project. Install the Web Clipper. Connect live data. Put maintenance on a schedule. Full walkthrough is in the guide.

License and pricing

MIT license. Open source. No pricing.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/undefined-uisecond-brain-os.svg)](https://yunodb.com/tools/undefined-uisecond-brain-os?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/undefined-uisecond-brain-os?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/undefined-uisecond-brain-os.svg" alt="Featured on YunoDB" height="20"></a>