capture

/devkb:capture — save session ideas to your Obsidian knowledge base

Turn ideas that came up while working into durable, linkable notes in the user's Obsidian vault. Two modes:

• A specific idea — the user points at one thing ("save that idea about caching the cost snapshot"). Capture just that.
• Sweep the session — the user asks to capture everything worth keeping ("grab any ideas from this session"). Scan the conversation and pull out the genuinely new, reusable ideas.

Curate. An idea worth a note is a reusable insight, design direction, or thing-to-build — not a task you just finished, a bug you fixed, or routine status. When in doubt, prefer fewer, sharper notes over many thin ones.

Where the vault is

Read the vault path from ~/.config/mesh44/config.json:

{
  "obsidian": {
    "vault": "/Users/<you>/Documents/Obsidian Vault",
    "folder": "devkb"
  }
}

• Notes go in a devkb folder inside the vault. If obsidian.folder is unset, default to devkb; if the obsidian key is missing entirely, default to ~/Documents/Obsidian Vault and devkb — and tell the user you're using the default and they can set obsidian.vault / obsidian.folder to change it.
• If the vault directory doesn't exist, ask the user for the vault path rather than guessing. Never write outside the vault.
• Create <vault>/<folder>/ if it doesn't exist yet.

Where in the folder — general vs project

The <folder>/ is organised into two kinds of subfolder:

• <folder>/general_learnings/ — cross-project, reusable insights: a pattern, a gotcha, a principle, a technique that would apply on any project.
• <folder>/<project>/ — anything specific to the project this session is about (an idea for this app, a decision, a thing to build here).

For each idea, decide which it is. Derive <project> as a clean slug from the repo/cwd — e.g. a session in www.mesh44.com is project mesh44 (drop a leading www. and a trailing TLD-like suffix). If a matching project folder already exists, reuse it exactly rather than making a near-duplicate. When genuinely unsure, prefer the project folder — it's easy to promote to general_learnings/ later.