{"id":48643638,"url":"https://github.com/scottkirvan/obsidibot","last_synced_at":"2026-05-10T21:15:48.796Z","repository":{"id":343319651,"uuid":"1170157734","full_name":"ScottKirvan/ObsidiBot","owner":"ScottKirvan","description":"More than a writing assistant — ObsidiBot turns your Obsidian vault into a personal AI platform","archived":false,"fork":false,"pushed_at":"2026-04-30T22:51:34.000Z","size":2427,"stargazers_count":8,"open_issues_count":31,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T00:16:21.998Z","etag":null,"topics":["agentic-ai","agentic-workflow","claude","claude-code","obsidian","obsidian-md","obsidian-plugin","writing-assistant"],"latest_commit_sha":null,"homepage":"http://www.scottkirvan.com/ObsidiBot/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScottKirvan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"ScottKirvan"}},"created_at":"2026-03-01T19:32:57.000Z","updated_at":"2026-04-30T22:47:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ScottKirvan/ObsidiBot","commit_stats":null,"previous_names":["scottkirvan/cortex","scottkirvan/obsidiancortex","scottkirvan/obsidibot"],"tags_count":38,"template":false,"template_full_name":"ScottKirvan/ScooterGitTemplate","purl":"pkg:github/ScottKirvan/ObsidiBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottKirvan%2FObsidiBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottKirvan%2FObsidiBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottKirvan%2FObsidiBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottKirvan%2FObsidiBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScottKirvan","download_url":"https://codeload.github.com/ScottKirvan/ObsidiBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottKirvan%2FObsidiBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32584651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agentic-workflow","claude","claude-code","obsidian","obsidian-md","obsidian-plugin","writing-assistant"],"created_at":"2026-04-09T23:59:59.244Z","updated_at":"2026-05-03T21:01:25.226Z","avatar_url":"https://github.com/ScottKirvan.png","language":"TypeScript","funding_links":["https://github.com/sponsors/ScottKirvan"],"categories":[],"sub_categories":[],"readme":"---\nlast_updated: 2026-04-30\nstatus: active\n---\n\n# ObsidiBot [![starline](https://starlines.qoo.monster/assets/ScottKirvan/ObsidiBot)](https://github.com/qoomon/starline)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/media/logo.png\" alt=\"ObsidiBot logo\" width=\"200\" height=\"auto\" /\u003e\n\n  \u003ch3\u003eMore than a writing assistant — ObsidiBot turns your Obsidian vault into a personal AI platform.\u003c/h3\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/ScottKirvan/ObsidiBot/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/ScottKirvan/ObsidiBot\" alt=\"contributors\" /\u003e\u003c/a\u003e\n    \u003ca href=\"\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/ScottKirvan/ObsidiBot\" alt=\"last update\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/ScottKirvan/ObsidiBot/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/ScottKirvan/ObsidiBot\" alt=\"stars\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/ScottKirvan/ObsidiBot/issues/\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/ScottKirvan/ObsidiBot\" alt=\"open issues\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/ScottKirvan/ObsidiBot/blob/main/LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/github/license/ScottKirvan/ObsidiBot.svg\" alt=\"license\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003ch4\u003e\n    \u003ca href=\"https://www.scottkirvan.com/ObsidiBot/\"\u003eDocs\u003c/a\u003e ·\n    \u003ca href=\"https://discord.gg/TN6XJSNK5Y\"\u003eDiscord\u003c/a\u003e ·\n    \u003ca href=\"https://github.com/ScottKirvan/ObsidiBot/issues/new?template=bug_report.md\"\u003eReport Bug\u003c/a\u003e ·\n    \u003ca href=\"https://github.com/ScottKirvan/ObsidiBot/issues/new?template=feature_request.md\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/h4\u003e\n\u003c/div\u003e\n\n\nTurn Obsidian into a tool that reaches beyond PKM, notetaking, storage, and organization. Safely extend it to match how you think, and what you do.  You're in control and everything happens using regular, conversational language — write, plan, build custom commands, even develop Obsidian plugins — without leaving Obsidian.\n\n\n| You ask…                                                                                                         | ObsidiBot does…                                                                                                          |\n| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\n| \"Summarize my meeting notes from last week\"                                                                      | Creates a summary note and opens it in your editor                                                                       |\n| \"Rename all my untitled notes based on their content\"                                                            | Finds them, renames them, reports back                                                                                   |\n| \"Find writing residencies in the US with open applications this year and draft a summary of costs and deadlines\" | Searches the web, compiles results, writes the summary note                                                              |\n| \"Turn this page into a Canvas mind map\"                                                                          | Generates a `.canvas` file from your note                                                                                |\n| \"Create a skill that summarizes my weekly notes into a report\"                                                   | Writes the skill file — available instantly as a `/` slash command, Ctrl+P command, and callable by any plugin or script |\n\n\u003e [!NOTE]\n\u003e **Status:** Public beta —  Feedback welcome on [Discord](https://discord.gg/TN6XJSNK5Y). Currently [submitted](https://github.com/obsidianmd/obsidian-releases/pull/12000) for inclusion as an Obsidian Community Plugin — awaiting review.\n## Installation\n *\\*Requirements:*\n- *Obsidian desktop (Windows, Mac, Linux — no mobile support)*\n- *[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code/overview) installed and authenticated — included in Claude Pro/Max subscriptions. (Windows,: install in PowerShell. Mac/Linux: use `curl -fsSL https://claude.ai/install.sh | bash`)*\n### Install Via BRAT (recommended)\n1. Install **BRAT** from the Obsidian community plugin browser\n2. In BRAT settings → **Add Beta Plugin** → `ScottKirvan/ObsidiBot`\n### Install Manually\n1. Download `obsidibot-\u003cversion\u003e.zip` from [Releases](https://github.com/ScottKirvan/ObsidiBot/releases)\n2. Extract to `\u003cyour-vault\u003e/.obsidian/plugins/obsidibot/`\n3. **Settings → Community Plugins** → enable **ObsidiBot**\n\n---\n## Quick Start\n\n1. Open the ObsidiBot panel from the ribbon (brain/circuit icon) or Command Palette: `ObsidiBot: Open agent panel`\n2. Type a message (ie. \"Hi!  Tell me about yourself.\") and press **Enter**\n3. See the [User Guide](https://www.scottkirvan.com/ObsidiBot/) for details on Skills, session management, and settings\n\n---\n## What makes ObsidiBot different?\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🔧 Create custom commands — expand Obsidian's capabilities\u003c/b\u003e\u003c/summary\u003e\n\n\u003c!--[GIF: Skills form modal opening, user filling fields, Claude executing]--\u003e\n\n\u003cbr\u003e\n\u003cb\u003eSkills\u003c/b\u003e are the \"bot\" in ObsidiBot. Write a natural language prompt, save it as a markdown file in your commands folder, and it becomes a first-class command — available in the '/' slash menu, in the Obsidian command palette with hotkey support, \u003cem\u003eand\u003c/em\u003e exposed as an API endpoint, callable by any plugin or script within Obsidian.\n\u003cbr\u003e\u003cbr\u003e\nAdd YAML frontmatter and Skills grow into parameterized forms that can prompt for input: dropdowns, text inputs, note pickers with fuzzy search. Your most-compicated recurring workflows become generalized, reusable, one-click operations.\n\u003cbr\u003e\u003cbr\u003e\n→ \u003ca href=\"https://www.scottkirvan.com/ObsidiBot/guide/skills.html\"\u003eLearn about Skills\u003c/a\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e✏️ Deep Obsidian integration\u003c/b\u003e\u003c/summary\u003e\n\n\u003c!--[GIF: ObsidiBot opening a file, navigating to a heading, showing toast notification]--\u003e\n\n\u003cbr\u003e\nObsidiBot isn't a chat window bolted onto Obsidian. It integrates \u003cem\u003ewith\u003c/em\u003e Obsidian:\n\u003cbr\u003e\u003cbr\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cb\u003eObsidian UI control\u003c/b\u003e — opens files, splits panes, navigates headings, shows notifications\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eRun any command\u003c/b\u003e — execute anything from the command palette; and you control which commands are allowed and which aren't\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eLive vault graph\u003c/b\u003e — Claude can query backlinks, outlinks, tags, and file lists mid-reasoning\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eCanvas\u003c/b\u003e — reads and generates \u003ccode\u003e.canvas\u003c/code\u003e files natively\u003c/li\u003e\n\u003c/ul\u003e\n\u003cbr\u003e\n→ \u003ca href=\"https://www.scottkirvan.com/ObsidiBot/features\"\u003eFull feature list\u003c/a\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🔒 Your vault, your rules\u003c/b\u003e\u003c/summary\u003e\n\n\u003cbr\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cb\u003eConfigurable safety modes\u003c/b\u003e — readonly, standard, full access; blocked operations show an in-chat card with one-click upgrade\u003c/li\u003e\n\u003cli\u003e\u003cb\u003ePer-note frontmatter controls\u003c/b\u003e — pin notes to every session, inject per-note instructions, all via Obsidian Properties\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eVault-native memory\u003c/b\u003e — \u003ccode\u003e_claude-context.md\u003c/code\u003e persists context across sessions and syncs across machines\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eContext gauge\u003c/b\u003e — live session memory indicator below the input; one-click compaction\u003c/li\u003e\n\u003c/ul\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🌐 Reach beyond your vault\u003c/b\u003e\u003c/summary\u003e\n\n\u003cbr\u003e\nObsidiBot doesn't stop at the edges of your vault. Given proper permissions (which you control), it can search the web, work with files anywhere on your system, and interact with external services — and everything it finds comes back as a note, woven into your vault where it belongs.\n\u003cbr\u003e\u003cbr\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cb\u003eWeb search\u003c/b\u003e — Claude can search the web mid-conversation and bring results back as chat responses or notes\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eFilesystem access\u003c/b\u003e — ObsidiBot, under your direction, can read, write, and organize files anywhere on your system, not just inside the vault\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eExternal services\u003c/b\u003e — Home automation, calendar/weather, GitHub, etc.  For example, ObsidiBot can manage GitHub issues, pull in data, run CLI tools — all from a single conversational interface\u003c/li\u003e\n\u003cli\u003e\u003cb\u003eYour vault as hub\u003c/b\u003e — everything that comes in lands where you decide, searchable and linked\u003c/li\u003e\n\u003c/ul\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003c/details\u003e\n\n---\n\n## Support the project\n\nObsidiBot is free, open source, and built in spare time. If it's useful:\n\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/ScottKirvan?style=social)](https://github.com/sponsors/ScottKirvan)\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for project layout, development setup, and PR process.\n\n## License\n\nMIT — see [LICENSE.md](LICENSE.md)\n\n---\n\n[CHANGELOG](notes/CHANGELOG.md) · [User Guide](https://www.scottkirvan.com/ObsidiBot/) · [Roadmap](https://github.com/users/ScottKirvan/projects/3)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottkirvan%2Fobsidibot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscottkirvan%2Fobsidibot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottkirvan%2Fobsidibot/lists"}