Cli Anything Obsidian
- 482 installs
- 46.6k repo stars
- Updated August 3, 2026
- hkuds/cli-anything
cli-anything-obsidian is a Python CLI skill that reads, searches, and updates Obsidian vault notes through the Obsidian Local REST API for developers who need agents to manage knowledge bases without the GUI.
About
cli-anything-obsidian is a terminal skill from the cli-anything family that talks to Obsidian through the Local REST API so agents can search vaults, edit notes, and run commands headlessly. Install it with pip as cli-anything-obsidian; it requires Python 3.10+ and a running Obsidian instance with the REST API enabled. Developers reach for it when runbooks, meeting notes, and project wikis must stay synchronized with code changes during agent-assisted sessions. The skill suits power users who want vault maintenance scripted beside git workflows instead of manual note hopping.
- Vault search and note CRUD
- Markdown-safe agent edits
- Tag and link operations
- Runbook and wiki maintenance
- Local-first knowledge sync
Cli Anything Obsidian by the numbers
- 482 all-time installs (skills.sh)
- +18 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #120 of 550 CLI & Terminal skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-obsidianAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 482 |
|---|---|
| repo stars | ★ 46.6k |
| Last updated | August 3, 2026 |
| Repository | hkuds/cli-anything ↗ |
How do you manage Obsidian notes from the terminal?
Read, search, and update Obsidian vault notes from the terminal so agents can maintain runbooks, meeting notes, and project wikis alongside code changes in daily knowledge work.
Who is it for?
Developers who keep engineering runbooks and project wikis in Obsidian and want agent-driven terminal access to the vault.
Skip if: Teams without Obsidian installed or without the Local REST API plugin configured for headless access.
When should I use this skill?
User asks to read, search, create, or update Obsidian notes from CLI or during agent knowledge-management tasks.
What you get
Updated vault notes, search results, and CLI-driven Obsidian commands
- Updated vault notes
- Search results
- CLI command output
By the numbers
- Requires Python 3.10+
- Installed via pip install cli-anything-obsidian
Files
cli-anything-obsidian
Knowledge management and note-taking via the Obsidian Local REST API. Designed for AI agents and power users who need to manage notes, search the vault, and execute commands without the GUI.
Installation
This CLI is installed as part of the cli-anything-obsidian package:
pip install cli-anything-obsidianPrerequisites:
- Python 3.10+
- Obsidian must be installed and running with the Local REST API plugin enabled
Usage
Basic Commands
# Show help
cli-anything-obsidian --help
# Start interactive REPL mode
cli-anything-obsidian
# List vault files
cli-anything-obsidian vault list
# Run with JSON output (for agent consumption)
cli-anything-obsidian --json vault listREPL Mode
When invoked without a subcommand, the CLI enters an interactive REPL session:
cli-anything-obsidian
# Enter commands interactively with tab-completion and historyCommand Groups
Vault
Vault file management commands.
| Command | Description |
|---|---|
list | List files in the vault or a subdirectory |
read | Read the content of a note |
create | Create a new note |
update | Overwrite an existing note |
delete | Delete a note from the vault |
append | Append content to an existing note |
Search
Vault search commands.
| Command | Description |
|---|---|
query | Search using Obsidian query syntax |
simple | Plain text search across the vault |
Note
Active note commands.
| Command | Description |
|---|---|
active | Get the currently active note in Obsidian |
open | Open a note in the Obsidian editor |
Command
Obsidian command palette commands.
| Command | Description |
|---|---|
list | List all available Obsidian commands |
execute | Execute a command by its ID |
Server
Server status and info commands.
| Command | Description |
|---|---|
status | Check if the Obsidian Local REST API is running |
Session
Session state commands.
| Command | Description |
|---|---|
status | Show current session state |
Examples
List and Read Notes
# List all vault files
cli-anything-obsidian vault list
# List files in a subdirectory
cli-anything-obsidian vault list "Daily Notes"
# Read a note
cli-anything-obsidian vault read "Projects/my-project.md"Create and Update Notes
# Create a new note
cli-anything-obsidian vault create "Projects/new-project.md" --content "# New Project"
# Update (overwrite) a note
cli-anything-obsidian vault update "Projects/new-project.md" --content "# Updated Content"
# Append to a note
cli-anything-obsidian vault append "Projects/new-project.md" --content "\n## New Section"Search
# Plain text search (GET /search/simple/)
cli-anything-obsidian search simple "meeting notes"
# Dataview DQL query — default --type dql, sent as
# application/vnd.olrapi.dataview.dql+txt
cli-anything-obsidian search query 'TABLE file.link FROM "Projects"'
# JsonLogic query — application/vnd.olrapi.jsonlogic+json
cli-anything-obsidian search query --type jsonlogic \
'{"==":[{"var":"frontmatter.status"},"active"]}'Commands
# List available commands
cli-anything-obsidian command list
# Execute a command by ID
cli-anything-obsidian command execute "editor:toggle-bold"Interactive REPL Session
Start an interactive session for exploratory use.
cli-anything-obsidian
# Enter commands interactively
# Use 'help' to see available commandsAPI Key Configuration
# Via flag
cli-anything-obsidian --api-key YOUR_KEY vault list
# Via environment variable (recommended for agents)
export OBSIDIAN_API_KEY=YOUR_KEY
cli-anything-obsidian vault listState Management
The CLI maintains lightweight session state:
- API key: Configurable via
--api-keyorOBSIDIAN_API_KEYenvironment variable - Host URL: Defaults to
https://localhost:27124; configurable via--host
Output Formats
All commands support dual output modes:
- Human-readable (default): Tables, colors, formatted text
- Machine-readable (
--jsonflag): Structured JSON for agent consumption
# Human output
cli-anything-obsidian vault list
# JSON output for agents
cli-anything-obsidian --json vault listFor AI Agents
When using this CLI programmatically:
1. Always use `--json` flag for parseable output 2. Check return codes - 0 for success, non-zero for errors 3. Parse stderr for error messages on failure 4. Set `OBSIDIAN_API_KEY` environment variable to avoid passing --api-key on every call 5. Verify Obsidian is running with server status before other commands
More Information
- Full documentation: See README.md in the package
- Test coverage: See TEST.md in the package
- Methodology: See HARNESS.md in the cli-anything-plugin
Version
1.1.0
Related skills
Lark SharedWire Feishu/Lark Open Platform auth, tokens, and shared API helpers into agent-built bots and internal tools.514k
Runcomfy CliLet their coding agent call any RunComfy model from the terminal or scripts without managing separate SDKs.298k30
Skills CliDiscover, install, update, and manage reusable agent capabilities from the open Skillselion ecosystem directly inside their coding agent.270k71TzstCreate, extract, list, and script `.tzst` / `.tar.zst` archives from the terminal with the right compression, streaming, and conflict flags.267k71XdropPull files from an Xdrop share URL, decrypt them locally, and land outputs in a chosen directory with optional JSON for automation.266k71
WizardAuthor interactive bash setup wizards that open URLs, capture secrets, write .env upserts, and set GitHub Actions secrets step by step.104k202kFAQ
What are the prerequisites for cli-anything-obsidian?
cli-anything-obsidian requires Python 3.10+, installation via pip install cli-anything-obsidian, Obsidian installed locally, and the Obsidian Local REST API available for headless vault access.
What can cli-anything-obsidian do from the terminal?
cli-anything-obsidian reads, searches, and updates Obsidian vault notes and executes vault commands through the Local REST API so agents maintain runbooks and wikis without opening the Obsidian GUI.