harivansh-afk/deskctl
1
1
Fork 0
mirror of https://github.com/harivansh-afk/deskctl.git synced 2026-04-16 21:03:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

runtime contract enforcement (#6)

Browse source
This commit is contained in:
Hari 2026-03-25 22:00:16 -04:00 • committed by GitHub
parent 61f4738311
commit 543d41c3a2
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 958 additions and 157 deletions
Download patch file Download diff file Expand all files Collapse all files

8
skills/SKILL.md
View file

@ -90,6 +90,14 @@ deskctl daemon status # Check daemon status
- `--session NAME` : Session name for multiple daemon instances (default: "default")
- `--socket PATH` : Custom Unix socket path
## Output Contract
- Prefer `--json` when an agent needs strict parsing.
- Use `window_id` for stable targeting inside a live daemon session.
- Use `ref_id` / `@wN` for quick short-lived follow-up actions after `snapshot` or `list-windows`.
- Structured JSON failures expose machine-usable `kind` values for selector and wait failures.
- The exact text formatting is intentionally compact but not the parsing contract. See `docs/runtime-output.md` for the stable field policy.
## Window Refs
After `snapshot` or `list-windows`, windows are assigned short refs: