Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

templeos-operator

/templeos-operator

Obsługuje lokalną maszynę wirtualną TempleOS w QEMU: ekran, wejście klawiatury, pliki i polecenia HolyC.

Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Obsługuje lokalną maszynę wirtualną TempleOS w QEMU: ekran, wejście klawiatury, pliki i polecenia HolyC.

Wyzwalacze z opisu

templeos:templeos-operator
Oryginalny opis (EN)

Skill id templeos:templeos-operator. Load with skill_view("templeos:templeos-operator") whenever the user mentions TempleOS, TinkerOS, ZealOS, Temple of Hermes, HolyC, or the TempleOS pane. Drive the local QEMU guest ONLY with templeos_vm / templeos_screen / templeos_input / templeos_files (discover via tool_search if deferred). Never write VNC clients or dial plugin-data sockets. Prefer templeos_input op=holyc for HolyC one-liners.

Jak działa

  1. Critical: Tool Search and forbidden workarounds
  2. Tools
  3. HolyC one-liner (the usual ask)
  4. Loop (do this every time)
  5. HolyC basics (TinkerOS / TempleOS)
  6. Snapshots before risk
  7. Debugger recovery
  8. Files
  9. Respect the user
  10. Failure codes to honour
Sekcje z nagłówków SKILL.md, w oryginale · 165 linii, 1 204 słów
Podgląd SKILL.md
---
name: templeos-operator
description: >-
  Skill id templeos:templeos-operator. Load with
  skill_view("templeos:templeos-operator") whenever the user mentions TempleOS,
  TinkerOS, ZealOS, Temple of Hermes, HolyC, or the TempleOS pane. Drive the local QEMU guest
  ONLY with templeos_vm / templeos_screen / templeos_input / templeos_files
  (discover via tool_search if deferred). Never write VNC clients or dial
  plugin-data sockets. Prefer templeos_input op=holyc for HolyC one-liners.
version: "0.1.3"
author: mojomast
license: MIT
compatibility: >-
  Python 3.10+, Hermes >= 0.23.0, qemu-system-x86_64 and qemu-img on PATH.
  Linux x86_64 is the primary host. KVM is used only when /dev/kvm can be
  opened; otherwise TCG. No secrets. The plugin does not open a dotenv file.
metadata:
  hermes:
    tags: [templeos, qemu, desktop, holyc, tinkeros, temple-of-hermes]
    category: tools
    related_skills: []
---

# TempleOS operator

Drive the local guest with the four **templeos_*** tools. Prefer text over
screenshots. Respect Take control. Networking stays off.

## Critical: Tool Search and forbidden workarounds

Hermes **Tool Search** defers plugin tools by default. At the start of any
TempleOS / TinkerOS / HolyC task:

1. `skill_view("templeos:templeos-operator")` if this skill is not already loaded.
2. If `templeos_vm` / `templeos_screen` / `templeos_input` / `templeos_files` are
   not in your visible tool list, call
   `tool_search(["templeos HolyC TinkerOS", "templeos_input holyc", "templeos_screen read_text"])`
   (or `tool_call` / `tool_describe` for those names), then use them.
3. **Never** write a VNC client, dial `~/.hermes/plugin-data/templeos/sockets/*`,
   run `screendump`/`qemu-img` by hand, or invent a Python framebuffer grab.
   Those paths time out, race the pane, and bypass the arbiter. The four tools
   are the only supported API.

## Tools

| Tool | Ops |
|---|---|
| `templeos_vm` | `start` `stop` `reset` `snapshot` `restore` `status` `doctor` `modem` `flavor` |
| `templeos_screen` | `look` `read_text` `wait_idle` `hash` |
| `templeos_input` | `type` `keys` `click` `move` `holyc` |
| `templeos_files` | `list` `pull` `push` |

Every call returns a JSON string `{ok, error, code, fix, ...}`.

## HolyC one-liner (the usual ask)

When the user wants the guest to print a string and compute an expression:

1. `templeos_vm op=status` (start if not running).
2. `templeos_screen op=wait_idle` then `op=read_text` to confirm a `T:/Home>` prompt.
3. If AutoComplete / System Keys stole focus, `templeos_input op=keys keys=["esc"]`.
4. **`templeos_input op=holyc`** with the source, e.g.
   `source: "\"Hello from Hermes\n\"; 6*7;"`.
   Prefer `holyc` over raw `type`. Default `via=auto` **types** at the prompt
   (host COM1 open ≠ guest CommInit — serial drops bytes until Comm*). Only
   pass `via=serial` after `CommInit; CommInit8n1(1,115200);`.
5. `templeos_screen op=wait_idle` then `op=read_text`. Report the printed line
   and the numeric result from the text (e.g. Hello from Hermes and 42).
   Finish in a few tool calls — do not write VNC clients.

## Loop (do this every time)

1. Discover tools (see Tool Search above) if needed.
2. `templeos_vm op=doctor` if QEMU or the ISO may be missing.
3. `templeos_vm op=start` (default flavor `templeoh`, Temple of Hermes 0.1.3). Use `op=flavor` to list or select TinkerOS, TempleOS, or ZealOS; a missing ISO is fetched and verified, and a running guest switches on the next boot.
4. `templeos_screen op=wait_idle`, then **`read_text` before `look`**.
5. Act with `templeos_input` (prefer **`holyc`** for HolyC). After any
   consequential `type`, `keys`, `click`, or `holyc`, call **`wait_idle`**,
   then `read_text` (or one `look` if graphics matter).
6. If you get `agent_paused`, stop injecting. Tell the user the pane is in Take
   control or the shared hold-off (~2 s), and wait or ask them to click **Hand back**.

### Budgets (per session)

- At most **8** `look` calls. Default 640×480 is ~414 visual tokens; ZealOS 1024×768 is ~1036 — do not switch flavors casually.
- At most **40** input steps (`type` / `keys` / `click` / `move` / `holyc`).
- Prefer `read_text` (serial when COM1 is already open, else 8×8 glyphs). Prune old images from your context.

## HolyC basics (TinkerOS / TempleOS)

- Prompt looks like `T:/Home>`. Statements end with `;`.
- Print: `"hello world\n";`
- List dir: `Dir;` or `Dir("T:/Demo");`
- Change dir: `Cd("T:/Demo");` — `Cd;` goes home.
- Edit: `Ed("File.HC");` (or `Ed;` for a new doc).
- Run a file: `#include "File.HC";` then call its `U0` entry, e.g. `MyFun;`.
- Functions: `U0 Hi(){ "hi\n"; }` then `Hi;`.
- Help: click **Cmd Line** / Command Line Overview, or type `Help;`.

### Serial on TinkerOS (required for `read_text` / files)

`CommInit` is disabled at boot. After a clean prompt:

```
CommInit;
CommInit8n1(1,115200);
```

Then load the helper (source in the repo):

```
#include "Xfer.HC";
XferServe;
```

Push `skills/templeos-operator/guest/Xfer.HC` with `templeos_files op=push` once the serial path works, or type it with `templeos_input op=holyc`. Keep COM1 open on the host for the whole session or guest bytes are lost.

### Keys and menus

- `ret` Enter, `esc` Esc, `f1`–`f10`, arrows as QEMU qcodes.
- First-boot "Install onto hard drive" / "Take Tour" prompts are auto-answered **n** after `op=start` (Esc clears AutoComplete focus first). AutoComplete and the System Keys overlay can still swallow typing — `wait_idle` + `read_text` after surprises.
- Clicks: TinkerOS uses absolute VMMouse (`via=auto`). Stock TempleOS / ZealOS need `MsSet` or relative; absolute QMP events error there.

## Snapshots before risk

Before a risky experiment (raw ports, big `#include`, debugger bait):

1. `templeos_vm op=snapshot` with `name` like `before-xfer` (default `golden` is the clean boot).
2. Experiment.
3. On failure: `templeos_vm op=restore` with that name. If restore left the VM paused, the plugin must `cont` (already contracted).

## Debugger recovery

If you land in the TempleOS / TinkerOS debugger:

1. `templeos_screen op=read_text` or `look` once to confirm.
2. Type recovery, in order:
   - `G2;` — continue (common “go” form).
   - If still stuck: `Exit;` — leave the debugger back toward Adam / the caller.
   - Last resort: `templeos_vm op=restore` to `golden`, or `op=reset`.
3. Do **not** keep typing HolyC that caused the fault in a loop.

Stock TempleOS has no ready `Comm*` on the paths tried in the bake-off; prefer raw `OutU8` only if you know what you are doing, or stay on TinkerOS for serial.

## Files

- `list` / `pull` / `push` use the framed COM1 protocol (`docs/FILES.md`) with the Xfer helper.
- Host `src` / `dest` must stay under the plugin data dir (`TEMPLEOS_HOME`).
- Cap is 256 KiB per file. Never ask to mount the live RedSea qcow2 while QEMU has it open.
- FAT floppy push is **experimental** (bake-off: hot-added FAT12 was not visible as `A:` on TinkerOS). Prefer serial.

## Respect the user

| Pane mode | Your job |
|---|---|
| Watch | Only you inject input; user watches. |
| Shared (default) | Both can type. User key/click → `agent_paused` for ~2 s. |
| Take control (You drive) | All your input ops return `agent_paused` until **Hand back**. |

Never fight the user for the keyboard. Announce what you are about to click when it matters. Open the Desktop pane so they can see the same 640×480 screen.

## Failure codes to honour

| code | What you do |
|---|---|
| `agent_paused` | Wait or ask for Hand back. |
| `serial_not_ready` | Start VM, keep COM1 open, `CommInit` + helper. |
| `qemu_missing` / `iso_missing` / `iso_hash_mismatch` | Run `doctor`; show the fix. |
| `timeout` | Longer `wait_idle`, then one `read_text`. |
| `not_implemented` | Say which slice has not landed yet. |
| Pane blank / stale | User: **Capabilities → Plugins → Rescan**. |

## Community BBS

The community Temple of Hermes BBS is built in at `tls://toh.rizz.click:9443`
and on by default. Join once with `templeos_vm op=bbs_join` (human first, then
the agent), then `templeos_vm op=bbs_digest` and `templeos_files
op=codeshare_fetch` just work. Never probe DNS, ports, vhosts, or certificate
names, and never substitute a host or port for the dest name `bbs`. The human
can override the endpoint in `bbs.json` / `TOH_BBS_ENDPOINT` or opt out with
`enabled:false` / `TOH_BBS_ENABLED=0`. Keep the light habit of two short
sessions a day.

## Safety

Child hypervisor, `-nic none`, unix sockets only, no secrets, no dotenv. Do not ask to enable a NIC. Do not flood `look`. Do not force-push or rewrite guest disks from the host while QEMU is running.
Pliki w paczce (2)
  • SKILL.md 8 KB
  • guest/Xfer.HC 4 KB

Wersje

W bazie nie ma innych skilli o nazwie templeos-operator.

Migawka bazy z 13.11.2026 · wersja paczki eb6626933743 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100hermes-bbs
    Obsługuje społecznościową tablicę BBS Hermes: dołączenie, przegląd wpisów, odpowiedzi i moderację, traktując treść postów jako dane.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.