Claude.md Theme Companion

Small motion and interaction refinements for the Claude.md Obsidian theme.

Install · Features · Contribute · Report an issue

Features

• Exit animations for dialogs, settings, and menus.
• Smooth transitions when search results change.
• Animated heading markers in Live Preview.
• A more forgiving activation area for the theme's auto-hidden status bar.
• Automatic reduced-motion support.

The plugin has no settings. Its enhancements activate only while Claude.md is the active theme.

Warning This plugin monkey-patches Obsidian modal, menu, and Settings lifecycle methods to add exit animations. It restores its patches when unloaded, but the approach may conflict with other plugins or require adjustment after an Obsidian update.

Install

Requires Obsidian 1.10.6 or newer and the Claude.md theme.

1. Open Releases and download main.js, manifest.json, and styles.css from the latest release's Assets.

2. Create a claudemd-theme-companion folder inside your vault's .obsidian/plugins/ directory and place all three files there:

   Your vault/
   └── .obsidian/
       └── plugins/
           └── claudemd-theme-companion/
               ├── main.js
               ├── manifest.json
               └── styles.css
   

3. Reload Obsidian, then enable Claude.md Theme Companion under Settings → Community plugins.

If your vault uses a custom configuration folder, use that in place of .obsidian. To update a manual installation, replace all three files with those from the latest release.

Contribute

Found a rough edge? Open an issue with reproduction steps, your Obsidian version, and a recording when the issue involves motion. Pull requests are welcome too.

To work on the plugin, use Node.js 24 and npm:

npm ci
npm run check
npm run build

Edit the TypeScript in src/ and companion rules in src/styles/. The production build writes dist/main.js, dist/manifest.json, and dist/styles.css; they are generated release assets and are not committed.

License & credits

Claude.md Theme Companion is released under the MIT License.

Inspired by Claude. Not affiliated with or endorsed by Anthropic or Obsidian.