obsidian-plugin/rait-09_obsidian-agent-client
1
0
Fork 0
mirror of https://github.com/rait-09/obsidian-agent-client.git synced 2026-07-22 16:30:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
rait-09_obsidian-agent-client/docs/getting-started/index.md
RAIT-09 7588824366 docs(getting-started): add Obsidian 1.11.4 prerequisite 
Document the minAppVersion bump driven by Obsidian's Keychain API,
which the plugin now uses to store agent API keys.
2026-05-22 18:43:35 +09:00

2.8 KiB
Raw Permalink Blame History

Installation

Install the Plugin

From Community Plugins (Recommended)

  1. In Obsidian, open Settings → Community Plugins → Browse
  2. Search for "Agent Client"
  3. Click Install, then Enable

Add to Obsidian

Via BRAT (Pre-release Versions)

To try pre-release versions before they are published to Community Plugins:

  1. Install the BRAT plugin from the Community Plugins browser
  2. In Obsidian settings, go to Community Plugins → BRAT → Add Beta Plugin
  3. Paste this repo URL: 
    https://github.com/RAIT-09/obsidian-agent-client
  4. BRAT will download the latest release and keep it auto-updated
  5. Enable Agent Client from the plugin list

Manual Installation

  1. Download the latest release files from GitHub Releases:
    • main.js
    • manifest.json
    • styles.css
  2. Create the plugin folder: VaultFolder/.obsidian/plugins/agent-client/
  3. Place the downloaded files in this folder
  4. Enable the plugin in Obsidian Settings → Community Plugins

Prerequisites

Obsidian Version

Agent Client requires Obsidian 1.11.4 or later. The plugin uses Obsidian's Keychain (introduced in 1.11.4) to store agent API keys securely.

::: tip Check your version under Settings → General → Version. If you are on an older version, update Obsidian from the official installer or your package manager. :::

Node.js

::: tip Not always required Node.js is needed for npm-based agents like Claude Code, Codex, and Gemini CLI. If your agent is a standalone binary, you can skip this step. :::

If you need Node.js:

  1. Download from nodejs.org
  2. Install the LTS version (recommended)

Find Your Node.js Path

If auto-detect doesn't find Node.js, you can locate it manually. Open a terminal (Terminal on macOS/Linux, PowerShell on Windows) and run:

::: code-group

which node
# Example output: /usr/local/bin/node

where.exe node
# Example output: C:\Program Files\nodejs\node.exe

:::

Configure Node.js Path

In most cases, the plugin automatically finds Node.js through your login shell's PATH, so no configuration is needed. If Node.js is not detected automatically:

  1. Open Settings → Agent Client
  2. Click the Auto-detect button next to the Node.js path field, or enter the path manually

Next Steps

Continue to Quick Start to set up your first agent and start chatting!