By ibenjamin
End-to-end org-roam workflows for Claude Code: 9 slash commands, 5 skills (atomic-notes, org, org-roam, fetch, dashboard), and the org-roam MCP server. Requires the Homebrew-installed bins (ortk-mcp, ortk-emacs-eval, ortk-fetch, ortk-ocr).
原子笔记 (org-roam) 创建与管理规范:双语标题/标签、:ZH: drawer 折叠中文、 双层 References (inline + 汇总 + archive.today)、AI 生成内容标记、织入知识图谱原则。 当 commands 创建笔记或对话中讨论笔记格式时自动应用。 Triggers: 原子笔记, atomic note, 概念笔记, Zettelkasten, roam note, org-roam, 双语笔记, :ZH:, drawer, FILETAGS, 织入图谱, References, archive.today, ai_generated, 双向链接
Local observability dashboard for the org-roam-toolkit monorepo. Shows Emacs daemon health, MCP server status, org-roam config and graph stats in a web UI. Triggers: dashboard, daemon health, mcp status, org-roam stats, observability, 状态, 监控, 看板, daemon 死了, server 没反应
Playwright headless browser for fetching web pages that require JavaScript rendering. Use when WebFetch fails or returns empty content. Includes per-site extraction strategy (WeChat 图文 with image extraction, archive.* with extended timeout) and OCR helpers. Triggers: WebFetch失败, 微信公众号, mp.weixin.qq.com, 需要JS渲染, archive.today, archive.ph
Org-mode formatting and org-roam note management via emacsclient. Never use Read/Write/Edit on roam notes directly. Triggers: roam note, org-roam, org-mode, .org files, Zettelkasten, backlinks
Org-mode agenda 和 capture 操作,通过 emacsclient 管理日程和快速捕捉。 Triggers: agenda, todo, capture, 日程, 待办, 捕捉, task, 任务
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
MCP server, observability dashboard, and Claude Code plugin for an Emacs / org-roam knowledge base. Distributed as a Homebrew tap.
macOS only.
# 1. Install the bins via Homebrew
brew tap iBenjamin/tap
brew install org-roam-toolkit
# 2. Symlink the Claude Code plugin into ~/.claude/plugins/
ln -snf "$(brew --prefix org-roam-toolkit)/libexec/plugins/org-roam-toolkit" \
~/.claude/plugins/org-roam-toolkit
# 3. (optional) Auto-start the dashboard at login
brew services start org-roam-toolkit # http://127.0.0.1:9876
After step 2, restart Claude Code to load the plugin.
| Bin (on PATH) | What it does |
|---|---|
ortk-mcp | Rust MCP server for org-roam (registered as org-roam in the plugin's .mcp.json) |
ortk-emacs-eval | Universal emacsclient --eval wrapper that auto-loads project elisp packages via --pkg=NAME |
ortk-fetch | Playwright headless fetcher with per-site extraction strategies (WeChat, archive.today, …) |
ortk-ocr | Tesseract.js OCR helper |
ortk-dashboard | Local dashboard at http://127.0.0.1:9876 showing daemon / MCP / org-roam health |
Plus the Claude Code plugin under plugins/org-roam-toolkit/:
/note, /study, /deep_note, /reference, /ref-extract, /to-read, /read-history, /add-toolkit, /gen-commit-msgatomic-notes (format spec), org (agenda + capture), org-roam (note management), fetch (web + OCR), dashboard (observability)The slash commands are Chinese-language and opinionated — they encode a specific atomic-notes / Zettelkasten workflow. See plugins/org-roam-toolkit/skills/atomic-notes/SKILL.md for the format spec.
brew install)emacs --daemon) with org-roam loaded and org-roam-directory setfetch skill: npx playwright install chromium (one-time ~150MB Chromium download)org-roam-toolkit/
├── packages/
│ ├── emacs/ # @org-roam-toolkit/emacs — emacsclient wrapper + shared elisp
│ ├── web/ # @org-roam-toolkit/web — playwright fetchers + OCR
│ └── dashboard-server/ # ortk-dashboard — Rust crate (axum + HTMX, single static binary)
│
├── mcp-servers/
│ └── org-roam/ # ortk-mcp — Rust MCP server backed by ortk-emacs-eval
│
├── plugins/
│ └── org-roam-toolkit/ # Claude Code plugin (commands + skills + .mcp.json)
│
├── Formula/
│ └── org-roam-toolkit.rb # Source-of-truth Homebrew formula (mirrored to iBenjamin/homebrew-tap)
│
└── docs/ # developer documentation
packages/ are capability libraries — the implementations. mcp-servers/ and plugins/org-roam-toolkit/skills/ are adapters — they expose those capabilities to specific consumers (MCP clients, Claude Code).
End users install via Homebrew — the rest of this section is for working on the toolkit.
make install # npm install (workspaces)
make build # tsc -b (all TS packages)
make dashboard # build + run server in foreground on $DASH_PORT (default 9876)
make test # vitest + eldev tests (if Eldev present)
make lint # vitest lint hooks + eldev lint
make install-claude # symlink plugins/org-roam-toolkit into ~/.claude/plugins/ (dev mode)
make uninstall-claude # undo the above
To test the formula locally without publishing a tag:
brew install --build-from-source ./Formula/org-roam-toolkit.rb
(The committed url / sha256 only become valid once a release tag is pushed; before that, prefer --HEAD or --build-from-source against the local working copy.)
See docs/conventions.md and docs/developing-skills.md for code-level conventions.
MIT — see LICENSE.
npx claudepluginhub ibenjamin/org-roam-toolkit --plugin org-roam-toolkitHarness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.
Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer
Persistent file-based planning for AI coding agents. Crash-proof markdown plans (task_plan.md, findings.md, progress.md) that survive context loss and /clear, with an opt-in completion gate and multi-agent shared state. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard. Includes Arabic, German, Spanish, and Chinese (Simplified and Traditional).
v9.44.1 — Patch release for Gemini environment/version detection and qwen auth gating. Run /octo:setup.
Superpowers Plus core skills library for Claude Code: planning, execution routing, TDD, debugging, and collaboration workflows