How do I install the Widgets skill?

Run npx skillmds@latest add tomevault-io/widgets in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Widgets safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Widgets?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Widgets free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Widgets?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Widgets by tomevault-io — Agent Skill

Name: Widgets
Author: tomevault-io

File contents

Widgets

Widgets are local web apps proxied by term-llm serve web under the Web UI base path. In this container the webui service starts with widgets enabled:

term-llm serve web \
  --base-path "${WEB_BASE_PATH:-/chat}" \
  --enable-widgets \
  --widgets-dir /home/agent/.config/term-llm/widgets

Default widget directory:

/home/agent/.config/term-llm/widgets

Public route shape:

/chat/widgets/<widget-name>/

Adjust /chat if WEB_BASE_PATH is set differently.

Widget layout

Create one subdirectory per widget:

/home/agent/.config/term-llm/widgets/
└── example/
    ├── widget.yaml
    └── ... app files ...

widget.yaml is the manifest. Inspect existing widgets or the term-llm source for the exact supported fields before inventing a shape.

Useful source paths:

/home/agent/source/term-llm/internal/widgets
/home/agent/source/term-llm/cmd/serve.go

Workflow

Inspect existing widget support first:

rg "widget.yaml|enable-widgets|widgets-dir" /home/agent/source/term-llm

Add or edit files under the widgets directory.
Reload the widget registry; do not restart the whole Web UI just to pick up a new widget:

curl -fsS -X POST \
  -H "Authorization: Bearer ${WEB_TOKEN}" \
  http://127.0.0.1:8081/chat/admin/widgets/reload

Inspect widget status and load errors:

curl -fsS \
  -H "Authorization: Bearer ${WEB_TOKEN}" \
  http://127.0.0.1:8081/chat/admin/widgets/status

Smoke the route:

curl -i http://127.0.0.1:8081/chat/widgets/<widget-name>/

For authenticated browser access use the Web UI token from the workspace .env.

Rules

Keep widget state and source in the persistent /home/agent/.config/term-llm/widgets directory unless the user asks for a project-local mount.
Prefer small, inspectable apps over framework sprawl.
Do not expose secrets through static assets or client-side JavaScript.
After adding, removing, or changing widget manifests, use /chat/admin/widgets/reload; do not restart webui just to rescan widgets.
Restart webui only for service flag changes, binary upgrades, or if the admin reload endpoint itself is unavailable.

Source: SamSaffron/term-llm — distributed by TomeVault.

---name: widgetsdescription: Build, install, inspect, and debug term-llm Web UI widgets. Use when adding local widget apps, editing widget manifests, checking widget routes, or explaining how /chat/widgets works. Use when this capability is needed.---# WidgetsWidgets are local web apps proxied by `term-llm serve web` under the Web UI base path.In this container the `webui` service starts with widgets enabled:```bashterm-llm serve web \ --base-path "${WEB_BASE_PATH:-/chat}" \ --enable-widgets \ --widgets-dir /home/agent/.config/term-llm/widgets```Default widget directory:```bash/home/agent/.config/term-llm/widgets```Public route shape:```text/chat/widgets/<widget-name>/```Adjust `/chat` if `WEB_BASE_PATH` is set differently.## Widget layoutCreate one subdirectory per widget:```text/home/agent/.config/term-llm/widgets/└── example/ ├── widget.yaml └── ... app files ...````widget.yaml` is the manifest. Inspect existing widgets or the term-llm source for the exact supported fields before inventing a shape.Useful source paths:```bash/home/agent/source/term-llm/internal/widgets/home/agent/source/term-llm/cmd/serve.go```## Workflow1. Inspect existing widget support first:```bashrg "widget.yaml|enable-widgets|widgets-dir" /home/agent/source/term-llm```2. Add or edit files under the widgets directory.3. Reload the widget registry; do not restart the whole Web UI just to pick up a new widget:```bashcurl -fsS -X POST \ -H "Authorization: Bearer ${WEB_TOKEN}" \ http://127.0.0.1:8081/chat/admin/widgets/reload```4. Inspect widget status and load errors:```bashcurl -fsS \ -H "Authorization: Bearer ${WEB_TOKEN}" \ http://127.0.0.1:8081/chat/admin/widgets/status```5. Smoke the route:```bashcurl -i http://127.0.0.1:8081/chat/widgets/<widget-name>/```For authenticated browser access use the Web UI token from the workspace `.env`.## Rules- Keep widget state and source in the persistent `/home/agent/.config/term-llm/widgets` directory unless the user asks for a project-local mount.- Prefer small, inspectable apps over framework sprawl.- Do not expose secrets through static assets or client-side JavaScript.- After adding, removing, or changing widget manifests, use `/chat/admin/widgets/reload`; do not restart `webui` just to rescan widgets.- Restart `webui` only for service flag changes, binary upgrades, or if the admin reload endpoint itself is unavailable.---> Source: [SamSaffron/term-llm](https://github.com/SamSaffron/term-llm) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions

Widgets

File contents

Widgets

Widget layout

Workflow

Rules

Related skills

Frequently asked questions

How do I install the Widgets skill?

What does the Widgets skill do?

Is Widgets safe to use?

Which AI agents work with Widgets?

Is Widgets free to use?

Who published Widgets?