# Boardstate: Hermes Agent plugin

> A live board your agent builds for you: tabs of notes, tables, charts, KPI cards and live Hermes data, in the dashboard and Hermes Desktop.

Canonical: https://hermeswatcher.com/plugins/boardstate  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/boardstate  
Last updated in catalog: 2026-10-17

A live board your agent builds for you: tabs of notes, tables, charts, KPI cards and live Hermes data, in the dashboard and Hermes Desktop. It appears as a Board tab in the dashboard and a page in Desktop, and the agent lays it out with 19 native boardstate_* tools, approval widgets included. Runs a local Node >= 20 sidecar on loopback with a per-spawn nonce; no network access unless you opt in to operator-gated connectors.

## Good to know before installing

Spawns a local Node.js ≥20 sidecar (from PATH/HERMES_NODE_BIN, nothing downloaded) on 127.0.0.1 on first use; state under HERMES_HOME/boardstate-state/. Reads the dashboard's loopback session token from Hermes internals (web_server._SESSION_TOKEN) and passes it to the sidecar for live usage/sessions/cron widgets; mounts one token-gated static route for approved widget assets. No outbound network unless you author boardstate.connectors.json (stdio/HTTP MCP connectors); connector actions need operator approval. Ships one plugin skill, boardstate:boardstate-report-problem, which drafts a bug report and files it with the GitHub CLI only after the user approves the exact text.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install boardstate
```

2. Said no? Turn it on later:

```bash
hermes plugins enable boardstate
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Automation & multi-agent, Work & business, Hermes Desktop add-ons
- Maintained by: 100yenadmin (Community)
- Needs: No API keys declared
- Adds tools: `boardstate_workspace_get`, `boardstate_tab_create`, `boardstate_tab_update`, `boardstate_tab_delete`, `boardstate_tabs_reorder`, `boardstate_widget_add`, `boardstate_widget_update`, `boardstate_widget_move`, `boardstate_widget_remove`, `boardstate_layout_set`, `boardstate_workspace_replace`, `boardstate_undo`, `boardstate_widget_catalog`, `boardstate_design_review`, `boardstate_tool_search`, `boardstate_widget_scaffold`, `boardstate_data_read`, `boardstate_connector_read`, `boardstate_connector_invoke`
- Requires Hermes: `>=0.21.2`
- Version: 1.5.2
- In the catalog since: 2026-09-23, updated 2026-10-17

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/boardstate)
- [Source code](https://github.com/100yenadmin/boardstate-hermes-plugin#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt