brothyFAQ
Short answers about platforms, fonts, AI, Obsidian and what brothy is not.
Does it run on Windows?
Section titled “Does it run on Windows?”No: macOS and Linux only (x64 and arm64 binaries).
The logo is a box.
Section titled “The logo is a box.”The bowl in the top line is a Nerd Font glyph. Use a Nerd Font in your terminal or ignore it; nothing else depends on it.
Does brothy send my notes anywhere?
Section titled “Does brothy send my notes anywhere?”Not unless you add an ai block and press an AI key. With one, each request goes only to the endpoint you configured. What is sent lists every request.
Can I use a local model?
Section titled “Can I use a local model?”Yes: Ollama and LM Studio need no key. See Set up a provider.
Can it edit notes?
Section titled “Can it edit notes?”brothy is a reader for a folder of notes, not an editor. e opens the note in your $VISUAL / $EDITOR at the line you are reading, and brothy reloads when it exits.
Does it work with Obsidian vaults?
Section titled “Does it work with Obsidian vaults?”It reads them: wikilinks, embeds, callouts, highlights, comments and dataview blocks. See Obsidian notes.
Why does a link look muted?
Section titled “Why does a link look muted?”A wikilink is muted when no note matches it.
Copying text did not work.
Section titled “Copying text did not work.”Selecting text copies through OSC 52, so your terminal must allow it.
How do I change the theme?
Section titled “How do I change the theme?”t, or brothy -t <name>. See Theme picker.
How do I read something from a pipe?
Section titled “How do I read something from a pipe?”curl -s … | brothy. See Pipes & editor.
What else is there?
Section titled “What else is there?”glow (pager and note stash), mdcat (renders to stdout), frogmouth (Python TUI browser), bat (syntax-highlighted cat) and Obsidian itself.
Where do I report a bug?
Section titled “Where do I report a bug?”On GitHub. Security problems go privately, see SECURITY.md.