Skip to content

v0.2.0

Choose a tag to compare

View all tags
@kidboy-man kidboy-man released this 27 Jun 06:38
v0.2.0
2a3345b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v0.2.0 — Second Brain Kit + Gemini & Cursor Kits

What's new

Second Brain kit (vibe-engineering kits second-brain install)

A full Obsidian + qmd wiki vault installer for AI agents. One command scaffolds a personal knowledge base wired to every supported agent.

Vault scaffold

  • Creates structured vault: wiki/, docs/, agent-snippets/
  • Seeds starter pages: hot.md, index.md, log.md
  • Writes per-agent setup guides for Claude Code, Cursor, and Codex

Agent integration

  • Injects AGENTS.md with qmd MCP config for Claude Code
  • Drops second-brain.mdc rule into Cursor's .cursor/rules/
  • Writes qmd-mcp.toml config for Codex
  • Registers vault as a qmd collection (qmd collection add)

Safety contract

  • Detects foreign vaults via manifest sentinel — warns before touching any vault it didn't create
  • --no-setup-deps flag skips optional npm/qmd setup prompts
  • --yes suppresses all interactive prompts (CI-safe)
  • --dry-run prints every action without writing files

Operations

  • doctor — checks qmd, npm, git, vault health; prints actionable exit matrix
  • diff — shows which kit files differ from vault
  • uninstall — removes only files the kit owns; leaves user content intact

Gemini kit (vibe-engineering kits gemini install)

Installs GEMINI.md persona + engineering rules for Gemini CLI. Mirrors the existing Claude Code kit structure.

Cursor kit (vibe-engineering kits cursor install)

Installs .cursor/rules/ with seven MDC rule files: persona, operating model, Go backend, testing, security, database, and uncertainty handling.

Internals

  • kit_registry.py — central registry; all kits register here, CLI dispatch iterates one place
  • merge_strategies.py — TOML deep-merge for agent config files; preserves user keys
  • secret_policies.py — redaction helpers to keep secrets out of diff output
  • **kwargs contract — all kit install() signatures accept **kwargs so CLI can add flags without breaking existing kits
  • CI: Python 3.10 compatibility fix (tomllib stdlib backport)

Tests

252 tests, 55 subtests — all green.

New test files:

  • tests/test_second_brain_installer.py — 1165 lines, covers scaffold, doctor, diff, uninstall, safety contract, config merge, agent snippets
  • tests/test_gemini_installer.py
  • tests/test_cursor_installer.py
  • tests/test_merge_strategies.py
  • tests/test_kit_registry.py
  • tests/test_manifest_contracts.py

Docs

  • docs/second-brain-setup.md — full setup guide (455 lines): prerequisites, install walkthrough, agent integration, qmd search tutorial, vault structure reference
  • README.md — updated kit table, second-brain section, corrected "never runs network commands" claim

Breaking changes

None. Existing claude-code and opencode kit installs unchanged.

Assets 2
Loading