Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ These are **not bundled with `hermes-agent`**. The core repo ships only the plug
| [`plugin-llm-async-example`](./plugin-llm-async-example) | `ctx.llm.acomplete()` + `asyncio.gather()` | Async LLM lane — concurrent forward + sentiment + back-translation pass for `/translate` |
| [`example-dashboard`](./example-dashboard) | `dashboard/manifest.json` | Bare-minimum dashboard plugin — a tab, a slot injection, a backend route |
| [`strike-freedom-cockpit`](./strike-freedom-cockpit) | dashboard theme + slot plugin | Complete custom-skin reskin — palette, layout variant, asset slots, sidebar HUD |
| [`openai-shadcn-desktop`](./openai-shadcn-desktop) | Desktop `THEMES_AREA` + theme-gated layout | Accessible light/dark palette, floating pane shell, polished composer, instant rollback |

## Installing an example as a user plugin

Expand All @@ -25,6 +26,7 @@ cp -r hermes-example-plugins/plugin-llm-example ~/.hermes/plugins/
cp -r hermes-example-plugins/plugin-llm-async-example ~/.hermes/plugins/
cp -r hermes-example-plugins/example-dashboard ~/.hermes/plugins/
cp -r hermes-example-plugins/strike-freedom-cockpit ~/.hermes/plugins/
cp -r hermes-example-plugins/openai-shadcn-desktop ~/.hermes/desktop-plugins/openai-shadcn

# enable any with a slash command surface
hermes plugins enable plugin-llm-example
Expand All @@ -45,6 +47,7 @@ Pair each plugin in this repo with its docs page:
| `plugin-llm-async-example` | [Plugin LLM Access](https://hermes-agent.nousresearch.com/docs/developer-guide/plugin-llm-access) |
| `example-dashboard` | [Extending the Dashboard](https://hermes-agent.nousresearch.com/docs/user-guide/features/extending-the-dashboard) |
| `strike-freedom-cockpit` | [Extending the Dashboard](https://hermes-agent.nousresearch.com/docs/user-guide/features/extending-the-dashboard) |
| `openai-shadcn-desktop` | [Desktop Plugin SDK](https://hermes-agent.nousresearch.com/docs/developer-guide/desktop-plugin-sdk) |

## Contributing a new example

Expand Down
49 changes: 49 additions & 0 deletions openai-shadcn-desktop/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# OpenAI Shadcn — Hermes Desktop theme

A complete `@hermes/plugin-sdk` Desktop theme with a neutral light/dark palette
and an optional floating-panel treatment for the built-in layout tree.

![Dark preview](./assets/preview-dark.png)

## Demonstrates

- `THEMES_AREA` with full light and dark `DesktopTheme` palettes
- `requestTheme()` for an imperative, persisted activation
- `PALETTE_AREA` commands for activate and one-click rollback
- `ctx.storage` for user intent across plugin reloads
- Theme-gated CSS that disappears immediately when another theme is selected
- Stable `data-slot` / `data-tree-*` hooks for scoped Desktop polish

The CSS does not replace the pane tree. Sessions, profile/gateway routing,
resizing, collapsing, dragging, Files, Terminal, and Review remain core-owned.

## Install from this examples repository

```bash
mkdir -p ~/.hermes/desktop-plugins
cp -R openai-shadcn-desktop ~/.hermes/desktop-plugins/openai-shadcn
```

Hermes Desktop hot-loads the folder. If needed, run **Reload desktop plugins**
from `Cmd/Ctrl+K`.

The theme activates on first load. Palette commands:

- **Theme: activate OpenAI Shadcn**
- **Theme: return to Hermes default**

## Standalone distribution

The independently versioned package, release ZIPs, and update instructions live
at https://github.com/agentik-os/hermes-openai-shadcn.

## Notes

The plugin is intentionally production-shaped rather than a minimal one-method
snippet: the full palette and the floating layout are the behavior being shown.
All custom layout rules are gated by
`data-hermes-theme="openai-shadcn"`, so rollback is immediate and complete.

## License

MIT
Binary file added openai-shadcn-desktop/assets/preview-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading