explaingit

zzyong24/thirdspace-vault-template

19PythonAudience · pm founderComplexity · 2/5LicenseSetup · easy

TLDR

A ready-to-clone knowledge base template that lets AI agents like Claude Code and Cursor automatically organize your notes, run scheduled reviews, and draft content, no manual filing needed.

Mindmap

mindmap
  root((repo))
    What it does
      Auto-organizes notes
      Runs agent skills
      Schedules reviews
    Folder structure
      Inbox
      Daily journal
      Knowledge cards
      Projects
    Tech stack
      Python
      Obsidian
    Audience
      Knowledge workers
      Note-takers
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Clone the vault and have an AI agent automatically sort an inbox of unclassified notes into the correct project and knowledge-card folders.

USE CASE 2

Run the weekly review skill to get an AI-generated summary of journal entries, key decisions, and open action items from the past week.

USE CASE 3

Use the article-drafting skill to turn a collection of knowledge cards on a topic into a structured draft ready for editing.

USE CASE 4

Open the vault in Obsidian to view a GitHub-style activity heatmap and to-do dashboard alongside your linked notes.

Tech stack

PythonObsidian

Getting it running

Difficulty · easy Time to first run · 5min

Clone the repo and ask any supported AI agent to initialize the vault, no manual configuration steps required.

MIT license, use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

ThirdSpace Vault Template is a ready-to-clone knowledge base starter for people who want an AI assistant to manage their notes and documents for them. The idea is that instead of manually filing and organizing information, you describe what you want to an AI coding agent and the agent does the filing, linking, and retrieval on your behalf. The template is designed to work with any of the major AI coding agents, including Claude Code, Cursor, Windsurf, Codex, and several others. The structure follows a numbered folder system common in personal knowledge management: an inbox for anything unclassified, a daily journal folder, a knowledge-card folder, a project folder, a resources folder for attachments, an output folder for published work, and an archive. A hidden configuration directory at the root serves as the anchor point that tells AI agents this folder is a knowledge base rather than a code project. The template ships with sixteen built-in agent skills, which are named commands the AI can run for specific tasks: initializing the vault, writing a work log entry, generating a weekly or monthly review, drafting an article, and organizing knowledge cards, among others. Setup starts by cloning the repository and then asking any supported AI agent to initialize the vault. The agent reads the configuration files, installs the appropriate hooks for your operating system and agent platform, registers scheduled tasks, and makes the skills available globally, all without manual configuration steps. There are no hardcoded file paths, so the vault works from any directory on any machine. An optional Obsidian plugin called ThirdSpace Dashboard is bundled in the repository. Obsidian is a popular note-taking application that can open the vault as a graph of linked notes. The plugin adds a dashboard with file statistics, a GitHub-style activity heatmap, a to-do manager, and quick-action buttons. The plugin is not required for the AI-agent workflow to function. The license is MIT.

Copy-paste prompts

Prompt 1
Initialize my ThirdSpace vault. I am a product manager who tracks customer call notes, roadmap decisions, and team updates.
Prompt 2
Write a work log entry for today's meeting about Q3 priorities and link it to the relevant project folder in my vault.
Prompt 3
Generate a weekly review from my journal entries for the past 7 days, listing key decisions made and open action items still pending.
Prompt 4
I have 20 unorganized notes in my inbox. File each one into the appropriate folder and link any notes that reference the same topic to each other.
Open on GitHub → Explain another repo

← zzyong24 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.