安装

添加到你的 Claude Code skills 目录：

# Add to your Claude Code skills
git clone https://github.com/benoror/obsidianos_work

安全报告

已验证

上次扫描：—

{
  "status": "PASSED",
  "issues": []
}

README.md

ObsidianOS: Work

Name: obsidianos_work
Author: benoror

An Obsidian vault wired with AI agent skills — an Agentic Operating System for Thinkers.

Sneak Peek

Slash commands that run inside your vault, powered by any AI agent:

/meeting                  → Create notes from Google Calendar
/cache-notes              → Embed AI meeting transcripts
/fill-participants        → Resolve names to [[@Person]] wikilinks
/followup-todos           → Extract action items as plain markdown bullets (no Tasks checkboxes)
/note-status              → Verify notes are fully processed
/recap                    → Weekly summary from email, Slack, Jira & vault
/commit                   → Stage & commit with inferred intent
/sync-upstream-obsidianos → Pull updates from upstream ObsidianOS

Agent-agnostic — works with Cursor, Claude Code, OpenCode, or any MCP-compatible client. Clone it, fill in USER.md, and go.

Compatible agents

Agent Support level Notes

Cursor IDE Full Loads .cursor/rules/ and .cursor/mcp.json automatically

Cursor CLI (cursor) Full Same engine in background/headless mode

Claude Code Full Reads AGENTS.md + CLAUDE.md natively; see CLAUDE.md for QMD MCP setup

OpenCode / Crush Full Reads OpenCode.md; see OpenCode.md for QMD MCP setup

OpenClaw Full Workspace skills in skills/ (symlink to .agents/skills/); config in ~/.openclaw/openclaw.json

Other MCP-compatible clients Partial Can use the QMD MCP server; agent instructions won't auto-load

Skills

Skill What it does

/meeting Create or wrap up meeting notes (from Google Calendar or manual)

/cache-notes Fetch & embed AI meeting transcripts as Obsidian callouts

/fill-participants Resolve names in notes to [[@Person]] wikilinks

/followup-todos Extract action items as plain markdown bullets (no Tasks checkboxes)

/recap Weekly recap from emails, Slack, Jira, and vault notes

/note-status Verify meeting notes are fully processed (Notes, Cache, Participants, Todos)

/commit Stage and commit — accepts file/folder scope, free-text intent, or amend

/sync-upstream-obsidianos Pull structural updates from upstream ObsidianOS

defuddle Clean markdown from URLs via Defuddle CLI

json-canvas JSON Canvas (.canvas) authoring

obsidian-bases Obsidian Bases (.base) views, filters, formulas

obsidian-cli Vault operations via the obsidian CLI (Obsidian must be running)

obsidian-markdown Obsidian Flavored Markdown conventions

Each skill supports multiple sub-commands and arguments — see AGENTS.md for the full reference. Skill proxies: .cursor/skills, .claude/skills, .opencode/skills, and repo-root skills/ are symlinks to .agents/skills/ so Cursor, Claude Code, OpenCode, and OpenClaw share one canonical tree.

Prerequisites

Cursor IDE or CLI (or any agent that supports MCP — see Compatible agents)
Node.js v20+
Obsidian (see Obsidian plugins below)
Google Workspace CLI (gws) — optional; required for /meeting (Calendar), /cache-notes / /fill-participants (Docs/Drive), and /recap (Gmail/Calendar). Install per § 3 in Setup below.

Setup

1. Clone and install

git clone https://github.com/youruser/obsos_work.git
cd obsos_work
npm install

2. Fill in your identity

Edit USER.md with your name, email, timezone, and aliases. This is the single source of truth that all skills reference — no other file needs your personal info.

3. Google Workspace CLI (optional)

Required for /meeting (list today’s Calendar events), /cache-notes / /fill-participants (read Gemini Google Docs), and /recap (Gmail + Calendar). All of these workflows are read-only; use OAuth scopes limited to what you need (e.g. Drive/Docs/Calendar/Gmail readonly).

Install gws — pick one:
GitHub Releases (pre-built binary)
brew install googleworkspace-cli
npm install -g @googleworkspace/cli
Authenticate (browser flow):

gws auth login

Use a scope preset or --scopes that includes readonly access for the APIs you use. Credentials are stored under ~/.config/gws/ by default. Optional env vars: see .env.example and the upstream README.

Command examples for agents are in .agents/skills/_shared/google-workspace-cli.md.

[!NOTE] Google Workspace is not exposed via MCP in this vault — agents run gws in the terminal. Cursor still loads QMD from .cursor/mcp.json only.

4. QMD vault search (optional)

Required for /recap and vault-wide search. QMD indexes your markdown files for keyword and semantic search.

npx qmd collection add . --name my_vault
npx qmd embed

The npx qmd mcp server (configured in .cursor/mcp.json) will serve searches from this index. Re-run npx qmd embed after adding significant new content.

5. Vault structure

The vault ships with these directories already in place:

Meetings/          Meeting notes (create subfolders per team/project as needed)
Teams/People/      Person files: @Name.md (one per colleague)
Teams/             Team files: +TeamName.md
Templates/         Obsidian templates

A default Teams/People/@Me.md is included as the vault owner's person file. Add subfolders under Meetings/ to organise notes by team or project (e.g. Meetings/Eng/, Meetings/TBs/).

6. Open in Obsidian + Cursor

Open the vault folder in both Obsidian (for viewing/editing notes) and Cursor (for running agent skills). Cursor will auto-load MCP servers from .cursor/mcp.json (this repo ships QMD only) and the rules from .cursor/rules/. Install and log in to gws separately for Google Workspace features.

In Obsidian, hide non-vault folders from the file explorer: go to Settings → Files & Links → Excluded files and add node_modules.

Obsidian plugins

The vault works with vanilla Obsidian, but these community plugins power specific features. Install whichever you need from Settings → Community plugins → Browse.

Required

Plugin ID Used by

Tasks obsidian-tasks-plugin ToDo's.md queries, task checkboxes & priorities elsewhere in the vault

Update modified date frontmatter-modified-date Auto-updates modified: in YAML frontmatter when you edit a note

Optional (cosmetic / workflow)

These are not required by any skill but improve the day-to-day experience:

Plugin ID What it adds

Obsidian Git obsidian-git Auto-backup vault to git on a schedule (alternative to /commit)

Auto Card Link auto-card-link Paste a URL and get a rich preview card

File Explorer Note Count file-explorer-note-count Shows note count badges on folders

Icon Folder obsidian-icon-folder Custom icons on folders and files in the explorer

Custom File Explorer Sorting custom-sort Manual sorting rules for files and folders in the explorer

Cycle Through Panes cycle-through-panes Ctrl/Cmd+Tab to cycle through open tabs like a browser

Optional (agent skills: Obsidian CLI stack)

These line up with the bundled kepano/obsidian-skills agent skills (obsidian-cli, json-canvas, obsidian-bases, obsidian-markdown). None are extra Community plugins unless noted — turn on the features you use, and keep Obsidian running when an agent drives the vault via the [Obsidian CLI](htt

常见问题

What is obsidianos_work?⌄

obsidianos_work is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by benoror. ObsidianOS - Work Vault. It has 159 GitHub stars.

Is obsidianos_work safe to use?⌄

obsidianos_work returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install obsidianos_work?⌄

Clone the repository with "git clone https://github.com/benoror/obsidianos_work" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is obsidianos_work written in?⌄

obsidianos_work is primarily written in JavaScript. It is open-source under benoror on GitHub, so you can review or fork the full source.

Are there alternatives to obsidianos_work?⌄

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh obsidianos_work against similar tools.

obsidianos_work

安装

快速入门