New Plugin: Obsidian Vault Agent Terminal with Claude Code/Codex

Share & showcase
1

:hammer_and_wrench: New Plugin: Obsidian Vault Agent

Hi everyone! :waving_hand:

I’m excited to share Obsidian Vault Agent — a powerful new plugin that integrates consoles, shells, and terminals inside Obsidian, enhanced with AI coding agent support.

:link: GitHub: liuyixin-louis/obsidian-vault-agent

:rocket: What It Is

Obsidian Vault Agent turns your Obsidian vault into an execution surface for interactive terminals and AI-aware coding workflows.
It’s a fork of the original obsidian-terminal plugin, but with AI-focused enhancements specifically designed to support tools like Claude Code, Cursor, and other agent workflows.

Instead of just a terminal emulator, Vault Agent includes:

  • AI Context Sync — exports active files/folders to .obsidian/ai-context.json for AI agents to consume

  • Drag & Drop File Paths — drag files/folders into the terminal and paste their path instantly

  • New Tab Button — quickly open new terminals

:brain: Why This Plugin

This plugin isn’t just another terminal in Obsidian — it’s designed as an execution substrate for AI agents.
That means terminals are first-class surfaces where AI models can operate with awareness of your vault’s structure, context, and files, not just side-panel assistants.

This fills a gap between:

  • vault templates focused on workspace organization

  • chat-based AI plugins

  • and simple terminal emulators

Vault Agent brings AI-contextualized execution directly into your note-centric workflow.

:package: Installation

You can install Obsidian Vault Agent in several ways:

  1. Manual install

    • Create .obsidian/plugins/terminal-ai in your vault

    • Download the latest release and place manifest.json, main.js, styles.css there

  2. Build from source

    • Clone the repo

    • npm install

    • npm run obsidian:install <vault path>

  3. Obsidian42 – BRAT

    • Add liuyixin-louis/obsidian-vault-agent as a beta plugin

    • See BRAT docs for instructions

Optionally, you can install Python dependencies for enhanced external terminal support on Windows (see README for details).

:test_tube: Who It’s For

This is especially useful if you:

  • want terminal workflows tightly integrated with your vault

  • use AI coding agents like Claude Code/Codex

  • need a consistent, context-aware workspace for notes + shell + agents

  • like custom terminal UX inside Obsidian

Whether you’re a power user, developer, or researcher building agent workflows, this plugin gives you a new way to act inside your vault.

:puzzle_piece: Feedback & Contributions

I’m happy to get your feedback, issues, or ideas!
Contributions are welcome — check out the GitHub repo for contribution guidelines