README file from
GithubIngester
An Obsidian plugin that watches a folder for new clippings and automatically triggers Claude Code's /ingest skill.
https://github.com/user-attachments/assets/90a5f6c5-6be5-4d86-a85c-ad9765efc7cc
How It Works
- Obsidian Web Clipper is used to save an article to e.g
raw/clippings/ - Plugin detects the new file
- Opens a new tmux window and runs
claude "/ingest <path>" - Claude Code processes the source into your wiki knowledge graph
Requirements
- Claude Code CLI installed and in PATH
- tmux running in your terminal
- zsh shell (macOS default; Linux users may need to install)
- The
/ingestskill defined at.claude/skills/ingest/SKILL.mdin your vault (seeskills/folder in this repo)
Installation
- Copy
main.js,manifest.json, andstyles.cssto.obsidian/plugins/ingester/ - Enable "Ingester" in Settings > Community Plugins
- Configure the watch folder in plugin settings
- Copy
skills/ingest/SKILL.mdto.claude/skills/ingest/SKILL.mdin your vault
Settings
| Setting | Default | Description |
|---|---|---|
| Watch Folder | raw/clippings |
Folder to monitor for new files |
| Auto-ingest | true |
Automatically run /ingest when new files are detected |
Note: The included
/ingestskill expects sources inraw/clippings/. If you change the watch folder, update the path references inSKILL.mdto match.
Disclosures
Account required: This plugin requires Claude Code CLI, which requires an Anthropic account and API access.
Network use: The plugin itself makes no network requests. However, when it invokes Claude Code, Claude Code connects to Anthropic's API servers to process your content. See Anthropic's Privacy Policy for details on data handling.
External program execution: This plugin executes external programs (tmux and claude) via Node.js child_process. It does not access files outside your Obsidian vault directly, but the invoked Claude Code session operates within your vault directory.
Desktop only: Requires desktop Obsidian due to dependency on system shell commands.
Development
npm install
npm run dev # Watch mode
npm run build # Production build