pochade-obsidian

Pochade Obsidian

The npx template for vibe-coded Obsidian plugins.

Quick Start

Create a new plugin instantly:

cd into the .obsidian/plugins folder of your Obsidian notebook and run:

npx pochade-obsidian {name of my new plugin}

This interactive CLI will set you up with:

• 🏗️ Modular Architecture: A clean src/ structure separating commands, settings, and main logic.
• 🤖 Agent-Ready Context: Includes LLM.md and AGENTS.md to help AI coding assistants understand your codebase immediately.
• ⚡ Hot Reload Support: Pre-configured for instant feedback loops.
• 🔧 Modern Tooling: TypeScript and esbuild configured for speed and safety.

Why Pochade?

I think vibe coding on production is a really bad idea. But for writing plugins for Obsidian I think it’s amazing.

With great power comes great responsibility, etc.

Structure that Scales

Instead of dumping everything into main.ts, Pochade organizes your code for the long haul:

my-plugin-name/
├── .hotreload           # Ready for hot-reload plugin
├── AGENTS.md            # System prompts for your AI agent
├── LLM.md               # Context on Obsidian API for LLMs
├── src/
│   ├── main.ts          # Lifecycle management
│   ├── settings.ts      # Settings UI
│   └── commands/        # One file per command
│       ├── insert-date.ts
│       └── ...
└── styles.css           # Clean, separate styling

Development

1. Navigate to your project:

   cd my-new-plugin
   

2. Start the dev server:

   npm run dev
   

3. Install in Obsidian:
   • Copy or symlink your folder to <Vault>/.obsidian/plugins/.
   • Enable the Hot Reload plugin in Obsidian for the best experience.

License

Unlicense (Public Domain). Build something beautiful.