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.
- Read/list/stat first. Stay in configured roots. For a large file, read a byte range with offset/length; binary content is refused.
- Edit a precise unique string with
hostctl.fs.edit; use more context after NOT_UNIQUE. Write/append publish atomically. Coordinate concurrent writers. - Use
hostctl.fs.trashto remove an entry. Never use permanent deletion, shell deletion or a different tool to bypass a refusal. - Prefer
hostctl.proc.execwith 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. - 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.
- 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.
- 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
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.
quick-research
Answer a factual or current question quickly from a few reliable sources, with citations and an honest confidence.
project-kickoff
Start a project with the Disney strategy and backcasting - target, milestones, a first order card, risks and bundled owner decisions.
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.
documentation-standards
Default documentation checks for coding-task completion.
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.