Skip to main content
plugin CX Codex

codex-obsidian — Claude Code plugin: what it does, how to install

codex-obsidian connects your agent to local Obsidian vaults via the official desktop CLI. Runs note queries, task rollups, and workspace controls.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-obsidian@awesome-codex-plugins
Open on GitHub

What codex-obsidian does

The plugin bundles seven specialized skills to interact with your Obsidian vault directly through the official desktop CLI. It handles note inspection, link tracking, frontmatter properties, templates, and bookmarks without modifying files outside documented CLI commands.

For multi-step actions, the obsidian-cli-workflows skill orchestrates routine jobs. You can preview commands before execution, such as rolling up tasks or bootstrapping daily notes. It also covers runtime diagnostics, hotkeys, themes, and snippets.

It relies strictly on the official desktop obsidian CLI. It will not work with third-party community CLIs. URL launcher automation via obsidian:// is also unsupported.

What it helps with

  • Inspect local notes, links, and frontmatter properties
  • Aggregate vault tasks using the tasks.rollup workflow
  • Prepare daily notes with daily.bootstrap in preview mode
  • Manage plugins, themes, and hotkeys directly through the CLI

Example prompts for the agent

  • Preview all open tasks with workflow_id=tasks.rollup mode=preview output=json
  • Bootstrap a daily note in the Work vault via workflow_id=daily.bootstrap mode=preview vault=Work
  • Switch workspace layout using workflow_id=workspace.focus_mode mode=apply

How to install codex-obsidian

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-obsidian@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about codex-obsidian

How to install codex-obsidian in Claude Code?

First run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install codex-obsidian@awesome-codex-plugins.

What does codex-obsidian do?

It connects Claude Code and Codex to local Obsidian vaults through the official desktop CLI, running note lookups, workspace controls, and admin tasks.

Does codex-obsidian support community Obsidian CLIs?

No, the plugin only supports the official desktop obsidian CLI and does not work with third-party tools or obsidian:// URIs.

Source text

codex-obsidian · MIT
# codex-obsidian

`codex-obsidian` is a Codex plugin for local Obsidian workflows through the official desktop `obsidian` CLI.

It currently ships seven focused skills:

- `obsidian-official-cli` for core note and metadata workflows.
- `obsidian-cli-bases-and-bookmarks` for Bases discovery/query and bookmark workflows.
- `obsidian-cli-runtime-admin` for plugin/theme/snippet and command/hotkey runtime administration.
- `obsidian-cli-devtools` for runtime diagnostics and developer-command workflows.
- `obsidian-cli-sync-and-publish` for Sync workflows and capability-gated Publish workflows with explicit side-effect guardrails.
- `obsidian-cli-workspace-and-navigation` for vault/workspace/tab/navigation and utility workflows.
- `obsidian-cli-workflows` for named one-command orchestration across the six domain skills with preview-first execution.

## What This Plugin Does

- Reads and inspects local Obsidian vault content through the official desktop CLI.
- Handles note, link, task, property, template, history, Bases, Bookmarks, Sync, developer-command, and workspace/navigation workflows that the documented CLI supports, with Publish handled only when detected as available in the local CLI.
- Exposes named one-command workflow IDs (for example `tasks.rollup`, `daily.bootstrap`, `workspace.focus_mode`) with preview/apply controls.
- Handles runtime administration for plugins, themes, snippets, and command/hotkey surfaces through documented CLI commands.
- Uses minimal local filesystem support only when that is needed to safely support an official CLI workflow.

## Skill Routing Quick Guide

- Use `obsidian-official-cli` for note content and knowledge workflows.
- Use `obsidian-cli-bases-and-bookmarks` for Bases and bookmark query/creation workflows.
- Use `obsidian-cli-runtime-admin` for runtime configuration and command registry workflows.
- Use `obsidian-cli-devtools` for runtime diagnostics, screenshots, and explicit eval/CDP workflows.
- Use `obsidian-cli-sync-and-publish` for Sync state and remote-side-effect operations, and for Publish only when publish commands are available.
- Use `obsidian-cli-workspace-and-navigation` for vault/workspace/tab/navigation operations and utility commands.
- Use `obsidian-cli-workflows` for named orchestration workflows that chain the domain skills in preview/apply mode.

See the detailed matrix and chaining recipes in:

- `skills/obsidian-official-cli/references/obsidian-cli-skill-routing-matrix-2026-04-21.md`

## One-Command Workflow Entry Point

Use explicit workflow command IDs through `obsidian-cli-workflows`:

- `workflow_id=tasks.rollup mode=preview output=json`
- `workflow_id=daily.bootstrap mode=preview vault=Work`
- `workflow_id=workspace.focus_mode mode=preview`
- `workflow_id=workspace.focus_mode mode=apply` (run only after preview + explicit confirmation)

## What This Plugin Does Not Do

- It does not target community Obsidian CLIs or plugin-specific APIs.
- It does not cover `obsidian://` launcher automation or Headless Sync workflows.
- It does not bundle MCP servers or connector apps in this version.

## Repository Layout

This repository is the plugin root.

```text
.
├── .codex-plugin/plugin.json
├── .agents/plugins/marketplace.json
├── assets/
└── skills/
```

The source of truth is the unpacked plugin content in this repository. There is no separate packaged copy.

## Local Install And Test Flow

1. Clone this repository locally.
2. Review `.agents/plugins/marketplace.json`. It exposes this repo as a local marketplace entry with `source.path` set to `./`.
3. Restart Codex so it reloads the repo marketplace metadata.
4. Open the plugin directory in Codex, choose `LumiCorp's Marketplace`, and install `codex-obsidian`.
5. Invoke one skill explicitly and run a small read-only task first to confirm install and routing boundaries.

Codex installs local plugins from a cached copy. After you change the plugin, restart Codex and reinstall or refresh from the repo marketplace flow so the installed copy picks up the new files.

## Publish Status

This repository is prepared to be shared on GitHub as a single public plugin repo.

OpenAI's current Codex plugin docs still describe official public plugin publishing as "coming soon," so this repo is structured for:

- GitHub distribution
- local marketplace installs
- future official directory publication when self-serve publishing is available

## Suggested GitHub Metadata

- Description: `Codex plugin for local Obsidian workflows through the official desktop CLI.`
- Topics: `codex-plugin`, `obsidian`, `obsidian-cli`, `agent-skill`, `openai-codex`

## Notes For Future Publish Prep

- GitHub repo: `https://github.com/greg-asher/codex-obsidian`
- Add an install-surface screenshot under `assets/` after the plugin has been verified through the local marketplace flow.

© Greg Asher · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Notes, tasks and projects →

From the same set391

The whole set →
codex-usage-tracker codex-usage-tracker is a Claude Code plugin that reads local Codex session logs for token summaries, session details, CSV exports, and dashboards. CX Codex ★ 1,596repo stars codex-tools-bridge codex-tools-bridge configures an experimental MCP bridge connecting ChatGPT Web to local Codex tools. It helps run local shell commands and edits directly from the web chat without a second model loop. CX Codex ★ 1,596repo stars codex-seo The codex-seo plugin for Claude Code and Codex runs site-wide or focused SEO checks on pages, technical issues, content, and backlinks. CX Codex ★ 1,596repo stars codex-reset codex-reset is a Claude Code plugin that connects read-only MCP tools for Codex limits. It reports a 24- or 48-hour reset forecast, verified reset records, and service status. CX Codex ★ 1,596repo stars codex-mem codex-mem carries compressed project context into later sessions. Use it when you need to pick up work after a session ends or reconnects. CX Codex ★ 1,596repo stars codex-image-plugin codex-image-plugin is a Claude Code plugin for generating and editing raster images through an OpenAI-compatible image API. It supports models, references, and masks. CX Codex ★ 1,596repo stars codex-discord-bridge codex-discord-bridge connects Codex CLI to a Discord bot via a Rust bridge. It lets you assign coding tasks remotely and approve agent actions with message buttons. CX Codex ★ 1,596repo stars be-serious The be-serious plugin gives agent text a formal scholarly register and includes a skill for reviewing prose. Use it when plans, explanations, or PR descriptions need a restrained tone. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open