Repository navigation
Releases
0.7.3
Fixed
- A terminal tab whose runtime cannot start says why. A tab on an SSH
runtime with no host, or on a runtime that has been removed, shows that
reason at once instead of "waiting for herdr" until a connection that
could never cure it.
Notes
- Architecture batch (#181): one endpoint resolver answers what is behind an
endpoint id (#182); the terminal seam is one call on the kind adapter
(#183); the native surface's wiring moves out of the terminal view into a
pane context (#184); the plugin root no longer names a runtime kind, with
Claude lifecycle, graduation and herdr status behind the adapters (#185).
No other behaviour change.
0.7.2
Changed
- Requires Obsidian 1.14.4 or later. Older Obsidian keeps 0.7.1, the last
release for it. - Settings are searchable: Obsidian's settings search finds a Gjetr
setting by name, "terminal engine" or "status bar counts" for example. A
field hidden by another choice is found through the row or page holding
it: "permission mode" finds the runtime pages. - Settings in pages: the tab opens on one line, "Active runtime: Local ·
connected", then one page each for Runtimes, Agents, Views, Terminal, and
Agent list and notifications. The entries show the default view and the
terminal engine. Every setting keeps its stored value and what it does. - The connection's details moved to the active runtime's page, at its
top, next to the fields they are about; the root line opens that page and
warns while the runtime is not connected. The Status group holds the live
connection only; a missing remote vault path or a kind this build cannot
run is under the page's Problems, once. - Runtimes and agent CLIs are lists with a page each: + adds a runtime and
opens its page, which shows only the fields its kind and target use, and
holds use or reconnect, order and remove; your agent CLIs get a page each
beside the built-in list. Adding opens the new page in both lists; a red
Remove on the page, or Delete on the focused row, removes after
asking, and the page goes back to the list. The Agents entry carries a
warning mark while one of your agent CLIs needs attention, as Runtimes does
for a runtime. A runtime added by Get started or made active from the
agent list shows in the list at once. - The agent list opens when you turn the plugin on, so a new user finds
it without the command palette. It opens only then, not on every start, so
a list you closed stays closed.
0.7.1
Added
- Tabs named after their folder on herdr-core: an agent started from a
folder gets a tab named after that folder in Herdr, as on herdr. A tab that
already has a name keeps it.
Fixed
- Native view after the terminal: a tab that had shown the terminal
(ghostty-web) before switching to the native view could not be typed in or
scrolled. The terminal engine no longer leaves its listeners behind. - Wheel in full-screen agents on herdr-core and Claude run by Obsidian:
the wheel scrolls the agent's own view (Claude Code's"tui": "fullscreen", for one) instead of stepping through its prompt history.
0.7.0 — Native UI
The native view catches up with Claude Code's own: answer it, steer it and
read it without switching to the terminal. Gjetr is now in Obsidian's
community plugins.
Added
- Answer from the view on herdr and herdr-core: questions (with typed
answers, option descriptions and the recommended one marked), permissions,
plans and the folder trust prompt, from the waiting card. The card says when
it is sending, shows errors inline, folds, and works from the keyboard. - Session bar in the prompt box: model, effort and permission mode
pickers, and the context used; a click on it shows Claude's context
breakdown. Works on herdr, herdr-core and Claude run by Obsidian. - Prompt box: one box with a toolbar strip. New settings Prompt box
style (Divided, Joined, Floating) and Context readout (Detail, or a
gauge with the tokens in its tooltip). - Queued prompts held by the plugin, with Send now, Edit and Discard.
- Images in prompts: shown in the conversation, pasted or dropped into the
prompt box. - To-do list rendered and kept in view; subagents followed while they
run; the plan on herdr and herdr-core read from Claude's plan file. - Copy a reply as Markdown or plain text, and a prompt.
- Timestamps and turn durations, and work Claude resumes on its own after
an answer. - Commands to focus the prompt, jump between turns and find in the
conversation; a jump-to-latest button. - Long sessions load a page of turns at a time, with earlier ones on request.
Changed
- Tool groups stay open while Claude writes, and their header says working,
needs you or done, with failed calls counted. Only changed items redraw. - Narrow sidebar and reduced-motion layouts; a failed read retries.
- A pane running another agent than Claude stays a terminal instead of
opening an empty native view. - README: install from the community plugins directory.
Fixed
- Enter in the prompt box threw "isOpen is not a function" when deciding
between picking a/or@suggestion and sending. - Prompts with a pasted image or block no longer vanish; compaction shows as a
divider; turns abandoned by a rewind or cancelled re-send go away; a/clear
inside the same file no longer keeps stale tool calls; Claude's own notices
show; background command notifications are told from subagents', and running
work is marked lost when Claude exits. - herdr panes find their transcript under
CLAUDE_CONFIG_DIRand in symlinked
folders. - A queued prompt that runs as its own turn is no longer dropped; Claude run by
Obsidian no longer stays working after its turn ends. - Typing into a herdr-core terminal no longer resizes it to 200×120.
0.6.1
Small changes for the community directory's review. Nothing changes in how the plugin works.
- New description: "Run persistent agents in your vault locally or remotely using herdr or herdr-core."
- Attested release files:
main.js,manifest.jsonandstyles.csscarry build provenance attestations, so you can check a download withgh attestation verify <file> --owner nytafar. - README: says what the plugin uses on your machine and why.
- Lint fixes: the CSS and code lint findings are fixed. Terminal underline and overline styles look the same as before.
If you're coming from 0.5.0 or earlier, read the 0.6.0 notes about the rename to Gjetr.
0.6.0
Herdr for Obsidian is now Gjetr
The plugin has a new id, gjetr, and a new name, Gjetr. Nothing else changes. Gjetr is still Herdr for Obsidian, in the same repository, nytafar/obsidian-herdr, so BRAT keeps working.
What updating does
- Settings carry over. On its first load, Gjetr copies your settings from
.obsidian/plugins/herdr/when that folder is this plugin's. It saves them once and says so in a notice. Another plugin's data in that folder is never read, and the old folder is left as it is. - The old copy is turned off. If this plugin's
herdrcopy is still enabled beside Gjetr, Gjetr disables it at load and tells you. You can delete.obsidian/plugins/herdr/afterwards. Another plugin with theherdrid is never touched. - New names in the interface. Commands now read Gjetr: Show agents and so on, and the settings tab is Settings → Gjetr. Hotkeys bound to the old commands have to be set again.
Everything else is as in 0.5.0. See CHANGELOG.md.
Install
BRAT: add nytafar/obsidian-herdr. Manual: put main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/gjetr/. Or let your coding agent do it, following docs/agent-install.md.
0.5.0
Runtimes
Herdr for Obsidian 0.5.0 no longer needs the herdr TUI. Your agents can run in herdr, in herdr-core (hc, herdrdev's headless runtime, the one behind Herdr UI), or in Claude Code run by Obsidian itself, on this machine or over SSH. You add them to a list of runtimes and switch between them from the agent list's toolbar. Each runtime gets the same list, actions and terminals, as far as that runtime allows.
A vault with no runtime yet opens a Get started card instead of an empty list. It can start Claude run by Obsidian straight away, or show herdr-core's official installer and run it in a terminal tab you watch. The plugin itself never downloads anything.
Read docs/runtimes.md for setup, and CHANGELOG.md for every change.
Highlights
- herdr-core, locally and over SSH:
- The list, status, pins and seen state, shared with Herdr UI through its own labels.
- The list is scoped to the vault's Herdr UI space, even when the space has no name, and agents you start land in that space.
- Native view on herdr-core, here and over SSH, through a Claude session hook that the plugin installs only after you agree.
- Claude, run by Obsidian:
claude -pdriven directly, with the native view. On Linux you also get a terminal view and shell tabs. - Agent CLI catalog on the + button, now at the far right of the toolbar:
- Left click starts the runtime's default agent. Right click lists the agent CLIs installed on that runtime's machine, plus your own entries (a wrapper, extra arguments).
- Settings show, for each CLI, which of your machines have it.
- A mise or asdf shim counts only when its tool is active in the vault folder.
- Remote herdr is found by itself when the remote binary field is empty: the remote PATH first, then Homebrew,
/usr/local/binand~/.local/bin. - The agent list's toolbar sits in the view's header.
- herdr types follow herdr 0.9.5.
Limits
- herdr over SSH shows terminals only, with no native view.
- Claude run by Obsidian has no terminal view on macOS yet (unverified) or on Windows.
- An SSH runtime still needs its remote vault path typed in. Finding it automatically is #124.
Install
BRAT: add nytafar/obsidian-herdr. Manual: put main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/herdr/. Requires Obsidian desktop 1.7.2+ on macOS or Linux, plus one runtime: herdr 0.8.0+ (running), herdr-core, or Claude Code.
0.4.0 — The native view
The native view
Herdr for Obsidian 0.4.0 brings Claude Code sessions into Obsidian's own Markdown rendering. The agent's prose reads like a note: wikilinks resolve, callouts and embeds work, your theme, fonts and readable line length apply. Each turn's tool calls fold into one quiet line, while the notes the agent changed stay in the text as "Updated [[note]]" links and web sources as source links. A chat-style prompt box with / command and @ vault-file completion sends or queues your next prompt, and when the agent stops to ask something, a card names the block and takes you to the terminal to answer it. A table of contents lists the session's turns and headings where Obsidian's outline lives.
It is a view for knowledge work first, kept distinctly apart from coding work. The native view is now the default for every tab; the terminal is one click away on the tab's header, each tab remembers its choice, and Default view in settings brings the terminal back as the default. A vault that had picked a terminal engine before this release keeps its terminals.
Read the full description in docs/native-view.md and every change in CHANGELOG.md.
Highlights
- Full session history on open, following new content;
/clearand--resumeare followed as the pane's session changes. - Tool groups, collapsed thinking, subagent reports as prose, steers shown inline where the agent picked them up.
- Prompt box: Send when idle, Queue while working,
/and@completion, first prompt to a fresh Claude works from the view. - Waiting card for startup trust, questions, plan approval and permissions, with Open in terminal. The trust prompt can be answered from the card, and Trust new folders automatically does it unasked. Nothing else is ever answered for you.
- Table of contents: Herdr: Show table of contents, follows the active view, click to scroll.
- Header button, tab menu and Herdr: Switch render mode toggle between native view and terminal.
- Agent status is polled from herdr, so status changes it never announces still reach the list.
Limits
Local panes and Claude Code only for now; remote panes and other agent kinds show a terminal. Questions and plan approvals are answered in the terminal.
Next up
The settings refactor, #120.
Install
BRAT: add nytafar/obsidian-herdr. Manual: put main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/herdr/. Requires Obsidian desktop 1.7.2+ and a running herdr 0.8.0+.
Full changelog: 0.3.0...0.4.0
0.3.0
What's Changed
Full Changelog: 0.2.0...0.3.0
0.2.0
What's Changed
New Contributors
Full Changelog: https://github.com/nytafar/obsidian-herdr/commits/0.2.0