README
Bedrock
Turn any Obsidian vault into a structured Second Brain with AI agents
Bedrock is a Claude Code plugin that automates Obsidian vault management through AI-powered skills. It organizes knowledge into 7 entity types following adapted Zettelkasten principles — entity detection, bidirectional linking, ingestion from external sources, deduplication, and sync.
No build system. No runtime. Just markdown files, AI agents, and your Obsidian vault.
Features
- 8 AI-powered skills — setup, ask, teach, preserve, compress, sync, healthcheck, and vaults
- 7 entity types — actors, people, teams, topics, discussions, projects, and fleeting notes
- External source ingestion — Confluence, Google Docs, GitHub repositories, and any file format supported by docling (DOCX, PPTX, XLSX, PDF, HTML, EPUB, images, and more)
- Bidirectional wikilinks — automatic cross-referencing with Obsidian graph view
- Hierarchical tags — multi-dimensional filtering (
type/,status/,domain/,scope/) - Zettelkasten structure — permanent, bridge, index, and fleeting note roles
- Trunk-based git workflow — structured commit conventions built in
Installation
/plugin marketplace add iurykrieger/claude-bedrock
/plugin install bedrock@claude-bedrock
For local development:
claude --plugin-dir ./claude-bedrock
Quick Start
After installing, run the setup wizard:
/bedrock:setup
This will guide you through:
- Language selection — choose the vault content language (default: English)
- Dependency check — verify
graphifyis installed (required) - Vault objective — pick a preset (engineering team, product management, company wiki, personal second brain, open source project, or custom)
- Scaffold — create directories, templates, config, and connected example entities
The setup creates all entity directories, copies templates, generates a vault-level CLAUDE.md, and scaffolds example entities with bidirectional wikilinks so you can see the graph in Obsidian immediately.
Skills
| Skill | Purpose |
|---|---|
/bedrock:setup | Interactive vault initialization and configuration |
/bedrock:ask | Orchestrated vault reader — decomposes questions, searches graph and vault, cross-references entities |
/bedrock:learn | Ingest external sources — extract and create entities |
/bedrock:preserve | Single write point — detect, match, create/update entities with bidirectional links |
/bedrock:compress | Deduplication and vault health — broken links, orphans, stale content |
/bedrock:sync | Re-sync entities with external sources |
/bedrock:healthcheck | Read-only vault health diagnostic — graphify-out integrity, orphans, dangling content, stale entries |
/bedrock:vaults | Manage registered vaults — list, set default, remove |
Vault Structure
your-vault/
├── actors/ # Systems, services, APIs (permanent notes)
├── people/ # Contributors, team members (permanent notes)
├── teams/ # Squads, organizational units (permanent notes)
├── topics/ # Cross-cutting subjects with lifecycle (bridge notes)
├── discussions/ # Meeting notes, conversations (bridge notes)
├── projects/ # Initiatives with scope and deadline (index notes)
└── fleeting/ # Raw ideas, unstructured captures (fleeting notes)
Each directory contains a _template.md defining the frontmatter schema for that entity type.
How It Works
Bedrock turns your vault into a living knowledge graph by combining 8 skills you invoke from Claude Code. You never write entities by hand — skills detect, create, and link them for you, with Obsidian rendering the result as a graph.
First-time use
- Open a folder you want to turn into a vault (or an existing Obsidian vault).
- Run
/bedrock:setup— answers a few questions and scaffolds directories, templates, and example entities. - Open the folder in Obsidian. You'll already see a connected graph.