# BojuBot [](https://github.com/qoomon/starline)
Turn 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.
| You ask… | BojuBot does… |
| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| "Summarize my meeting notes from last week" | Creates a summary note and opens it in your editor |
| "Rename all my untitled notes based on their content" | Finds them, renames them, reports back |
| "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 |
| "Turn this page into a Canvas mind map" | Generates a `.canvas` file from your note |
| "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 |
## Installation
*Requirements:*
- *Obsidian desktop (Windows, Mac, Linux — no mobile support)*
- *[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`)*
### From the Community Plugin Browser
1. Open Obsidian → **Settings → Community Plugins → Browse**
2. Search **BojuBot** → **Install** → **Enable**
Or find it at **[community.obsidian.md/plugins/bojubot](https://community.obsidian.md/plugins/bojubot)** → click **Add to Obsidian**.
### Install Manually
1. Download `main.js`, `manifest.json`, and `styles.css` from [Releases](https://github.com/ScottKirvan/BojuBot/releases)
2. Place them in `/.obsidian/plugins/bojubot/`
3. **Settings → Community Plugins** → enable **BojuBot**
---
## Quick Start
1. Open the BojuBot panel from the ribbon (brain/circuit icon) or Command Palette: `BojuBot: Open agent panel`
2. Type a message (ie. "Hi! Tell me about yourself.") and press **Enter**
3. See the [User Guide](https://www.scottkirvan.com/BojuBot/) for details on Skills, session management, and settings
---
## What makes BojuBot different?
🔧 Create custom commands — expand Obsidian's capabilities
Skills are the "bot" in BojuBot. 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, and exposed as an API endpoint, callable by any plugin or script within Obsidian.
Add 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.
→ Learn about Skills
✏️ Deep Obsidian integration
BojuBot isn't a chat window bolted onto Obsidian. It integrates with Obsidian:
- Obsidian UI control — opens files, splits panes, navigates headings, shows notifications
- Run any command — execute anything from the command palette; and you control which commands are allowed and which aren't
- Live vault graph — Claude can query backlinks, outlinks, tags, and file lists mid-reasoning
- Canvas — reads and generates
.canvas files natively
→ Full feature list
🔒 Your vault, your rules
- Configurable safety modes — readonly, standard, full access; blocked operations show an in-chat card with one-click upgrade
- Per-note frontmatter controls — pin notes to every session, inject per-note instructions, all via Obsidian Properties
- Vault-native memory —
_claude-context.md persists context across sessions and syncs across machines
- Context gauge — live session memory indicator below the input; one-click compaction
🌐 Reach beyond your vault
BojuBot 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.
- Web search — Claude can search the web mid-conversation and bring results back as chat responses or notes
- Filesystem access — BojuBot, under your direction, can read, write, and organize files anywhere on your system, not just inside the vault
- External services — Home automation, calendar/weather, GitHub, etc. For example, BojuBot can manage GitHub issues, pull in data, run CLI tools — all from a single conversational interface
- Your vault as hub — everything that comes in lands where you decide, searchable and linked
---
## Support the project
BojuBot is free, open source, and built in spare time. If it's useful:
[](https://github.com/sponsors/ScottKirvan)
---
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for project layout, development setup, and PR process.
## License
MIT — see [LICENSE.md](LICENSE.md)
---
[CHANGELOG](notes/CHANGELOG.md) · [User Guide](https://www.scottkirvan.com/BojuBot/) · [Roadmap](https://github.com/users/ScottKirvan/projects/3)
