Obsidian Code by Obsidian Labs

Turn a software goal into planned, reviewable and tested changes without leaving VS Code.

Obsidian Code reads the relevant files, proposes a short plan, edits the project, runs tools and shows you how the result was verified. You keep control of approvals, permissions and the final diff.

What you can finish with Obsidian Code

• Build a feature across multiple files.
• Find the root cause of an error and verify the fix.
• Review a change before shipping.
• Work with terminal, Git, MCP servers and project skills in one flow.
• Use images and repository context without copying everything into a browser.

Get a useful result in under five minutes

1. Install the extension and open Obsidian Code from the activity bar.
2. Choose how you want to run AI:
   • Free models: use OpenRouter's free router with your own OpenRouter key.
   • Local: connect Ollama or LM Studio on your machine.
   • Bring your own key: use any supported provider or OpenAI-compatible endpoint.
3. Open a project and choose one of the starter outcomes:
   • Build a feature
   • Find and fix a bug
   • Review before shipping

No card or Obsidian subscription is required. Provider usage belongs to the provider account you connect; local models run on your machine. Obsidian Labs does not pay for or resell that usage.

Your providers stay under your control

• API credentials are stored with VS Code SecretStorage.
• Credentials are not persisted in browser storage.
• OpenRouter free models can change based on provider availability and limits.
• Local models keep inference on your own machine, subject to the model and runtime you choose.
• You can switch provider profiles without rebuilding your project configuration.

Obsidian managed models — closed beta

Core, Pro and Ultra are currently available only to invited closed-beta users while we certify quality, latency and sustainable unit economics. Join the managed-model waitlist without blocking your free, BYOK or local workflow.

Keep the work verifiable

Obsidian Code is designed around a simple loop:

1. Understand the project and constraints.
2. Plan a small, reviewable path.
3. Build with files, terminal and tools.
4. Verify with tests and a final summary.

Use auto-approval only for the operations you trust. Sensitive actions remain governed by your VS Code permissions and Obsidian Code settings.

Project capabilities

Reusable project skills live in:

.agents/skills

You can also connect MCP servers, create custom modes and configure OpenAI-compatible providers. Managed Obsidian profiles appear only for invited accounts.

Plans and free learning

• Install the extension for free.
• Learn the workflow with practical Build Lab missions.
• Join the closed beta when you want to evaluate managed Core, Pro and Ultra capacity.
• Review invited usage and requests from your Obsidian Labs account.

See plans · Read the docs · Get support

Privacy and security

Obsidian Code only sends the context required for the task you initiate. API credentials are stored with VS Code secret storage. Review our privacy policy, terms and acceptable use policy.

Development

pnpm install
pnpm vsix

The generated extension package is written to bin/. Licenses and required open-source notices are available in LICENSE and NOTICE.