AGENT SKILL

hostctl

Operate the human's local computer through root-contained D109 tools, with bounded files and owned process sessions.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 0
Forks
0

01 前言 Front Matter

name
hostctl
useWhen
Inspect or change local files, run an owned process or use native desktop tools through authorized hostctl operations.
category
ops.system
description
Operate the human's local computer through root-contained D109 tools, with bounded files and owned process sessions.

03 SKILL.md 正文

Use only registered hostctl.* tools. They run locally inside the Harness; never start a remote host or expose a server for computer control.

  1. Read/list/stat first. Stay in configured roots. For a large file, read a byte range with offset/length; binary content is refused.
  2. Edit a precise unique string with hostctl.fs.edit; use more context after NOT_UNIQUE. Write/append publish atomically. Coordinate concurrent writers.
  3. Use hostctl.fs.trash to remove an entry. Never use permanent deletion, shell deletion or a different tool to bypass a refusal.
  4. Prefer hostctl.proc.exec with program, args array and root-contained cwd. For a long job use proc.start, retain its ID, inspect proc.read_output and close stdin/kill when done. IDs belong to the current agent/person/session and expire on session cleanup.
  5. Shell commands need explicit config opt-in and normal D109 approval. Executables are not OS-sandboxed by cwd. Use the smallest task and timeout; avoid secrets in arguments/environment. Never turn a denied file action into an executable workaround.
  6. Let the dispatcher request approvals only when needed; never claim a grant or surface trust. Foreign process termination uses proc.kill_foreign and a separate once approval. Clipboard reads require approval by default.
  7. Open only intended root files or HTTP(S) links. Clipboard/notifications need an interactive desktop; report UNAVAILABLE/IO_ERROR if a helper is missing.

Examples:

{"tool":"hostctl.fs.read","args":{"path":"notes.txt","offset":0,"length":4096}}
{"tool":"hostctl.fs.edit","args":{"path":"notes.txt","oldText":"Status: pending","newText":"Status: done"}}
{"tool":"hostctl.proc.start","args":{"program":"node","args":["scripts/check.mjs"],"cwd":"/granted/project","timeoutMs":120000}}
{"tool":"hostctl.proc.read_output","args":{"id":"ID_FROM_START"}}

Set shell.default to pwsh on Windows or bash/zsh on Unix; paths still use the host's rules. Trash uses Finder, Recycle Bin or freedesktop gio and never falls back to permanent deletion. No screen/input tools are available in this package.

04 同仓库更多 Skills

Cyb3rb1ade
Cyb3rb1ade/PLUR1BUS-Harness

frontend-gui-webdesign

Baut und restyled Frontend, GUI und Webdesign mit klarer Designrichtung statt generischem AI-Look. Nutzen bei Landingpages, Dashboards, Komponenten, HTML/CSS, React, Vue, Svelte, Design-Systemen, Typografie, Farbe, Motion, Accessibility und UI-Reviews.

★ 0
Cyb3rb1ade
Cyb3rb1ade/PLUR1BUS-Harness

quick-research

Answer a factual or current question quickly from a few reliable sources, with citations and an honest confidence.

★ 0
Cyb3rb1ade
Cyb3rb1ade/PLUR1BUS-Harness

project-kickoff

Start a project with the Disney strategy and backcasting - target, milestones, a first order card, risks and bundled owner decisions.

★ 0
Cyb3rb1ade
Cyb3rb1ade/PLUR1BUS-Harness

plur1bus-ops

Diagnose, configure and repair a PLUR1BUS installation — `1staid check`/`1staid repair`, `config get|set`, logs and the audit trail. Use when a PLUR1BUS supervisor, core or module looks unhealthy, a config change needs to go out safely, or an installation needs repair.

★ 0
Cyb3rb1ade
Cyb3rb1ade/PLUR1BUS-Harness

documentation-standards

Default documentation checks for coding-task completion.

★ 0
Cyb3rb1ade
Cyb3rb1ade/PLUR1BUS-Harness

document-design

The PLUR1BUS document design system (D100) — typography, colour tokens with WCAG AA contrast, page layout, and the nine templates (report, essay, white paper, proposal, one-pager, letter, invoice, CV, slide deck). Use whenever you produce a designed PDF document for a person via the `document.render` tool, or when you need the shared type scale, colour palette and layout rules.

★ 0