Commit Graph

21 Commits

Author SHA1 Message Date
Daniel
f8af8eb922 docs: add YouTube demo video to README
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10 01:26:20 +03:00
Daniel
f6224b7047 fix: correct plugin install command syntax in docs (v1.4.1)
The Claude Code plugin installation is a two-step process per the official
docs at code.claude.com/docs/en/plugin-marketplaces. There is no
'claude plugin install github:owner/repo' form. Users must first add the
marketplace catalog, then install the plugin from it by name.

Fixes:

* README.md: Option 2 install section now shows the two-step flow:
    claude plugin marketplace add AgriciDaniel/claude-obsidian
    claude plugin install claude-obsidian@claude-obsidian-marketplace

* docs/install-guide.md: Same correction, same syntax.

* plugin.json: 1.4.0 to 1.4.1
* marketplace.json: 1.4.0 to 1.4.1 (both metadata.version and
  plugins[0].version)

This fixes the reported "Plugin not found in any configured marketplace"
error users see when they try the old single-command form.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-08 22:38:21 +03:00
Daniel
6bab904d13 feat: v1.4.0 audit fixes, multi-agent compatibility, Bases dashboard
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>
2026-04-08 17:52:03 +03:00
Daniel
0f2e6e0f9b docs: remove all Nate Herk references from tracked files
- README.md: footer attribution + sources/ description
- ATTRIBUTION.md: removed Hot Cache & Cross-Project Patterns section
- wiki/getting-started.md: footer
- wiki/log.md: source reference
- wiki/meta/session note: inline mention

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 15:46:33 +03:00
Daniel
0d6519e057 docs: remove duplicate 1x1 GIF from What It Does section
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 15:35:14 +03:00
Daniel
40c910fb18 docs: replace cover with new Claude Obsidian branded assets
- Header: claude-obsidian-gif-cover-16x9.gif (16:9 animated cover)
- What It Does: 1x1 gif + welcome-canvas side by side
- Also adds static PNG variants (cover-16x9, cover-square) to wiki/meta/

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 15:24:01 +03:00
Daniel
1de3cc0936 rename: cosmic-brain → claude-obsidian
Updates all references across README, CLAUDE.md, ATTRIBUTION.md,
WIKI.md, docs/install-guide.md, wiki/getting-started.md,
plugin.json, marketplace.json, commands/wiki.md, setup-vault.sh,
wiki pages, and renames wiki/meta/cosmic-brain-cover.gif.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 15:13:18 +03:00
Daniel
36efd64f17 docs: move example screenshots to What It Does section for better visibility
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:43:23 +03:00
Daniel
a006c17941 docs: add graph view and wiki map screenshots to README Seed Vault section
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:41:38 +03:00
Daniel
dabc4cae89 docs: fix cover GIF path — rename to bypass CDN cache
Renames wiki/meta/cover.gif → wiki/meta/cosmic-brain-cover.gif to
force GitHub CDN to serve a fresh URL. Also removes stray root-level
cover.gif from a previous commit.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:33:42 +03:00
Daniel
abb95116c8 docs: add cover GIF header to README
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:28:34 +03:00
Daniel
f7f871b278 docs: move wiki-graph + workflow GIFs to Seed Vault section
Cleans up the README hero — welcome-canvas.gif now leads alone.
Graph and workflow GIFs moved to the bottom near Seed Vault where
they're contextually relevant.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:24:51 +03:00
Daniel
78addd13b9 docs: add welcome canvas GIF to README
Visual demo of the welcome.canvas board showing the three-zone
drop-process-grow layout.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:22:43 +03:00
Daniel
c8c27141d7 release: v1.2.0 — community-ready, full docs, PDF guide
Critical fixes:
- marketplace.json: fix version 1.0.0→1.2.0, fix email to ***REMOVED***
- main.canvas: remove 5 broken file references (gitignored files)
- community-plugins.json: deduplicate from 6→4 canonical entries

Vault onboarding:
- wiki/getting-started.md: new onboarding page inside the vault
- wiki/index.md: populate Entities, Sources, Questions, Comparisons sections
- wiki/meta/dashboard.md: fix Dataview queries (was referencing non-existent fields)
- welcome.canvas: add CTA node pointing to getting-started
- CLAUDE.md: replace placeholder text with actual vault description

Docs:
- README.md: complete Plugins section (pre-installed + recommended), CSS Snippets section, Banner usage section, file structure updated
- bin/setup-vault.sh: expanded success message listing all plugins and CSS snippets
- docs/install-guide.md + docs/install-guide.pdf: printable community install guide

Version: 1.1.0 → 1.2.0

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:20:23 +03:00
Daniel
5632763da6 chore: sync Obsidian state + fix .gitignore gaps
Modified files (Obsidian saved state):
  appearance.json       — CSS snippets enabled (Obsidian confirmed)
  community-plugins.json — Excalidraw + Banners enabled (Obsidian confirmed)
  graph.json            — Obsidian reset on close (expected)
  workspace.json        — welcome.canvas added as first tab by Obsidian
  README.md             — cover GIF header preserved by Obsidian
  welcome.canvas        — user added Cosmic Brain GIF at top

.gitignore additions:
  ????-??-??.md    — daily notes from Calendar plugin (personal)
  Excalidraw/      — user Excalidraw drawings (personal, not vault content)
  Untitled.canvas  — unnamed scratch canvases
  Claude SEO*.gif/png — personal brand assets in vault root
2026-04-07 13:54:26 +03:00
Daniel
98c0eeb3e6 fix: 13 skill review issues in /canvas
Critical:
- find precedence bug fixed: added \( -name '*.png' -o -name '*.jpg' \) grouping
  so -newer applies to BOTH extensions, not just .jpg
- Auto-positioning row y-detection: replaced broken right-half heuristic with
  min(n.y for all inside) — matches canvas-spec.md pseudocode
- WIKI.md canvas color table corrected: 1=red,2=orange,3=yellow,4=green,5=cyan,6=purple
  (was wrong mapping 1=blue etc from the graph CSS scheme, not canvas colors)

High:
- ID generation: full Unix timestamp (10 digits) instead of last-4-digits
  + added collision fallback (-2, -3 suffix)
- README: added /canvas add text and /canvas add pdf to commands table
- Aspect ratio: removed duplicate partial table from SKILL.md — now defers
  to canvas-spec.md as single source of truth
- new op: writes to wiki/overview.md not wiki/index.md (index has fixed schema)
- from banana: added explicit note that /banana is an optional external skill

Medium:
- add note: clarified 'type: file' vs 'type: link' — .md files use file nodes
- zone fallback y: changed from -140 (overlaps starter) to 280 (safe below all content)
- CLAUDE.md: added /save, /autoresearch, /canvas to Plugin Skills table

Low:
- allowed-tools: removed Grep (unused by any documented operation)
- Frontmatter: flattened description to single-line quoted string (fixes IDE
  YAML block scalar parsing diagnostic on lines 4-9)
2026-04-07 13:30:31 +03:00
Daniel
3b4f62eb0c feat: /canvas command — visual layer of the wiki
New files:
  commands/canvas.md              — slash command with full trigger table
  skills/canvas/SKILL.md          — complete skill: open, new, add image/text/pdf/note,
                                    zone, list, from-banana operations
  skills/canvas/references/canvas-spec.md — Obsidian canvas JSON spec:
                                    coordinate system, all node types, color table,
                                    image sizing by aspect ratio, auto-positioning
                                    pseudocode, common mistakes, full example

Auto-positioning algorithm (bbox math):
  - Finds rightmost node in target zone
  - Places next node at rightmost_x + 40, same row y
  - If overflow: wraps to new row (max_y_in_zone + 20)
  - Falls back to below all content if no zone found

Banana integration:
  - /canvas from banana: checks .recent-images.txt first, then
    filesystem find -newer 10min, presents list for confirmation
  - After any /banana run: suggests /canvas from banana

Updated:
  skills/wiki/SKILL.md        — added /canvas to routing table
  skills/wiki/references/plugins.md — added Calendar + Thino with
                                      pre-installed note + manual install fallback
  README.md                   — /canvas in commands table + file structure
2026-04-07 13:23:33 +03:00
Daniel
ece0d94523 feat: add animated GIFs + clean vault
GIFs (Remotion-rendered, FFmpeg palette-optimized):
- wiki/meta/wiki-graph-grow.gif (285KB, 6s, 15fps)
  Shows knowledge graph nodes appearing, coloring by type, edges connecting
  Color-coded: cyan=navigation, blue=concepts, purple=entities, green=sources
- wiki/meta/workflow-loop.gif (227KB, 5s, 15fps)
  Animated 4-step cycle: Drop Source → Claude Reads → Wiki Grows → Query
README: both GIFs shown side-by-side after the cover

Copyright clean-up (committed together):
- Removed Nate Herk source page and all 13 references
- Vault now 100% original content (3 concepts + 1 entity + navigation)
2026-04-07 12:55:48 +03:00
Daniel
f7dc0358f4 feat: add cover.gif as README banner (720x370, 1.2MB) 2026-04-07 12:45:51 +03:00
Daniel
f597342479 feat: ship workspace.json + setup-vault.sh for zero-config user experience
Users who clone the repo now get the full setup automatically:

- workspace.json tracked in git (removed from .gitignore)
  - Opens with Wiki Map canvas as default view
  - Graph view pre-configured: path:wiki filter, 5 color groups, proper physics
  - Obsidian reads this on first open before any state reset occurs

- bin/setup-vault.sh — one-time setup script
  - Writes correct graph.json (filter + colors)
  - Writes app.json (excludes plugin dirs from graph)
  - Writes appearance.json (enables vault-colors CSS)
  - Prints clear next-step instructions
  - Usage: bash bin/setup-vault.sh

- README updated: Option 1 now shows clone + setup.sh as recommended path
  - Clear explanation of what the script does
  - 2-minute setup flow vs manual configuration

Result: users clone, run setup.sh, open Obsidian — done.
Graph shows only wiki pages, color-coded, no noise.
2026-04-07 12:33:01 +03:00
Daniel
4dc6ff3b32 chore: sync vault to ~/cosmic-brain (Obsidian-registered path) 2026-04-07 12:05:18 +03:00