phg/hosts
0
0
Fork 0
Code Issues 4 Pull requests Projects Releases Packages Wiki Activity Actions

feat: Add agent-tui and tui-explorer skills with comprehensive documentation and scripts

Browse source
This commit is contained in:
Philip Henning 2026-09-04 20:03:30 +02:00
parent d5a143ee36
commit 6a3e1e0d5a
24 changed files with 708 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

21
.agents/skills/agent-tui/references/recovery.md Normal file
View file

@ -0,0 +1,21 @@
# Failure Recovery
Use this file when runs are flaky, stalled, or inconsistent.
## Common Failures and Fixes
- Text not found: re-run `screenshot`, wait for stability, then re-check expected text.
- Target not visible: use `press` navigation keys (for example `PageDown`, arrows), then re-snapshot.
- Wait timeout: increase `--timeout`, use `wait --stable`, then re-snapshot.
- No active session: `sessions` to list; re-run `run` if needed.
- Daemon not running: `daemon start`.
- Version mismatch: `daemon restart`.
- Unresponsive session: `kill --yes`, then re-run.
- Layout missing/overflow: `resize --cols --rows`, re-snapshot.
## Retry Budget
- Allow 3-5 retries for transient UI changes.
- If still failing, stop and ask the user for guidance or updated expectations.
## Escalation
- Last resort: `daemon stop --force --yes` then `daemon start`.
- Warn that `daemon restart` terminates all sessions.