6bab904d13
External audit flagged 8 actionable items against current best practices for Agent Skills, Claude Code hooks, Obsidian v1.9-v1.12, and JSON Canvas 1.0. This release addresses all of them and adds multi-agent compatibility files at zero cost to existing users. Tier 1, critical fixes: * wiki/meta/dashboard.base: NEW Obsidian Bases dashboard (native, no plugin needed). Replaces Dataview as the primary dashboard. Six views: Recent Activity, Seed Pages, Entities Missing Sources, Open Questions, Comparisons, Sources. * wiki/meta/dashboard.md: now embeds dashboard.base. Legacy Dataview queries retained as optional fallback for users on Obsidian < 1.9.10. * README.md and skills/wiki/references/plugins.md: Plugins section reorganized to recommend Bases (core, no install) primary, Dataview optional/legacy. * skills/canvas/references/canvas-spec.md: added missing JSON Canvas 1.0 fields. Group nodes now document background and backgroundStyle (cover, ratio, repeat). Edges document fromEnd (default 'none') and toEnd (default 'arrow') asymmetric defaults. Hex ID convention noted alongside descriptive ID alternative. * .gitignore: track wiki/meta/dashboard.base explicitly. Tier 2, important improvements: * hooks/hooks.json: SessionStart now uses both command type ([ -f wiki/hot.md ] && cat ...) and prompt type. Command type is the canonical safety check that works in non-vault sessions without erroring. Matcher: startup|resume. * hooks/hooks.json: NEW PostCompact hook re-injects hot cache after context compaction (hook-injected context does not survive compaction; CLAUDE.md does). * hooks/hooks.json: PostToolUse auto-commit now guarded by [ -d .git ]. * hooks/README.md: NEW documentation including known plugin-hooks STDOUT bug (anthropics/claude-code#10875) and workarounds. * skills/wiki/references/mcp-setup.md: added Option D (Obsidian CLI) for v1.12+. Added warning callout above NODE_TLS_REJECT_UNAUTHORIZED line explaining process-wide TLS bypass and recommending Option D as the secure alternative. * skills/wiki-ingest/SKILL.md: documented [!contradiction] custom callout CSS dependency on vault-colors.css snippet. * skills/wiki/references/css-snippets.md: full documentation of all four custom callouts (contradiction, gap, key-insight, stale) with built-in fallback equivalents. Tier 3, multi-agent compatibility (low complexity, high reach): * AGENTS.md: Codex CLI / OpenCode bootstrap. * GEMINI.md: Gemini CLI / Antigravity bootstrap. * .cursor/rules/claude-obsidian.mdc: Cursor always-on rules. * .windsurf/rules/claude-obsidian.md: Windsurf Cascade rules. * .github/copilot-instructions.md: GitHub Copilot conventions. * bin/setup-multi-agent.sh: idempotent symlink installer for Codex, OpenCode, Gemini, Cursor, Windsurf. Wires up the skills/ directory in each agent's expected location. Style cleanup: scrubbed all em dashes from every skill, hook, doc, and bootstrap file (249 total replacements across 26 files). Skills now use periods, commas, and colons throughout for cleaner natural prose. Version: 1.3.0 to 1.4.0 (aligns plugin.json with GitHub release tag format). Already resolved in v1.1 (no action needed): * defuddle, obsidian-bases, obsidian-markdown skills shipped * URL ingestion, vision ingestion, delta tracking docs * Multi-depth wiki-query (Quick / Standard / Deep) * PostToolUse auto-commit hook * allowed-tools field removed from all SKILL.md files * All templates already use plural tag/alias forms * Custom callouts CSS already in vault-colors.css Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
# Obsidian Setup
|
|
|
|
---
|
|
|
|
## Install Obsidian
|
|
|
|
### Linux (Flatpak: recommended)
|
|
|
|
Check if installed:
|
|
```bash
|
|
flatpak list 2>/dev/null | grep -i obsidian && echo "FOUND via flatpak" || \
|
|
which obsidian 2>/dev/null && echo "FOUND in PATH" || echo "NOT FOUND"
|
|
```
|
|
|
|
Install if not found:
|
|
```bash
|
|
flatpak install flathub md.obsidian.Obsidian
|
|
```
|
|
|
|
### macOS
|
|
|
|
```bash
|
|
ls /Applications/Obsidian.app 2>/dev/null && echo "FOUND" || brew install --cask obsidian
|
|
```
|
|
|
|
### Windows
|
|
|
|
```powershell
|
|
Test-Path "$env:LOCALAPPDATA\Obsidian" && echo "FOUND" || winget install Obsidian.Obsidian
|
|
```
|
|
|
|
### All platforms: direct download
|
|
|
|
https://obsidian.md/download
|
|
|
|
---
|
|
|
|
## Open the Vault
|
|
|
|
After installing: Obsidian > Manage Vaults > Open Folder as Vault > select your vault directory.
|
|
|
|
---
|
|
|
|
## Core Plugins (Built-in: No Install Required)
|
|
|
|
These ship with Obsidian. Enable them in Settings > Core Plugins:
|
|
|
|
| Plugin | Purpose |
|
|
|--------|---------|
|
|
| **Bases** | Native database-like views for `.base` files. Powers `wiki/meta/dashboard.base`. Available since Obsidian v1.9.10 (August 2025). **Replaces Dataview for most wiki use cases.** |
|
|
| **Properties** | Visual frontmatter editor. Always enabled. |
|
|
| **Backlinks** | Outgoing/incoming links pane. |
|
|
| **Outline** | Document heading navigation. |
|
|
|
|
## Recommended Community Plugins
|
|
|
|
Install via Settings > Community Plugins > Turn off Restricted Mode > Browse.
|
|
|
|
| Plugin | Purpose |
|
|
|--------|---------|
|
|
| **Templater** | Auto-populate frontmatter on note creation from `_templates/`. |
|
|
| **Obsidian Git** | Auto-commit every 15 minutes. Protects against bad writes. |
|
|
| **Calendar** | Right-sidebar calendar with word count, task, and link indicators. Pre-installed in this vault via `.obsidian/plugins/calendar/`. |
|
|
| **Thino** | Quick memo capture panel in right sidebar. Pre-installed via `.obsidian/plugins/thino/`. |
|
|
| **Iconize** | Visual folder icons for navigation. |
|
|
| **Minimal Theme** | Best dark theme for dense information display. |
|
|
| **Dataview** *(optional/legacy)* | Only needed if you're on Obsidian < 1.9.10 or want to use the legacy `dashboard.md` queries. The primary dashboard now uses Bases. |
|
|
|
|
**Calendar and Thino are pre-installed**. They ship with this vault. Enable them in Settings → Community Plugins → toggle on. No download needed.
|
|
|
|
If installing in a different vault: download `main.js` + `manifest.json` from their GitHub releases into `.obsidian/plugins/calendar/` and `.obsidian/plugins/thino/` respectively.
|
|
|
|
Optional additions:
|
|
- **Smart Connections**: semantic search across all notes
|
|
- **QuickAdd**: macros for fast note creation
|
|
- **Folder Notes**: click a folder to open an overview note
|
|
|
|
---
|
|
|
|
## Web Clipper
|
|
|
|
The Obsidian Web Clipper browser extension converts web articles to markdown and sends them to `.raw/` in one click.
|
|
|
|
Install for Chrome, Firefox, or Safari from the Obsidian website.
|
|
|
|
Set the default folder to `.raw/` in the extension settings.
|
|
|
|
---
|
|
|
|
## After Installing Plugins
|
|
|
|
1. Enable Bases: Settings > Core Plugins > toggle on (already on by default in Obsidian v1.9.10+)
|
|
2. Enable Templater: Settings > Templater > set template folder to `_templates`
|
|
3. Enable Obsidian Git: Settings > Obsidian Git > Auto backup interval: 15 minutes
|
|
4. Enable the CSS snippet: Settings > Appearance > CSS Snippets > toggle on `vault-colors`
|
|
5. *(Optional)* Enable Dataview only if you want the legacy `wiki/meta/dashboard.md` queries to work alongside the primary `dashboard.base`
|