tui-development

A helper for developing the robotics showcase’s terminal user interface, or TUI—a text-based screen with panes and reports. It separates display code from robotics logic so the logic can be tested without the optional UI library.

In plain words
What is it for?
Use it to change robotics report panes, launch helpers, screenshots, visual tests, rendering, styles, and progress or error reporting.
Why use it?
It prevents UI changes from bringing back removed workflows or hiding failures, while keeping reports usable in tests, command-line output, screenshots, and documentation.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/abdelstark/worldforge/tui-development
Any agent
npx skills add AbdelStark/worldforge --skill tui-development
Clone the repo
git clone --depth 1 https://github.com/AbdelStark/worldforge

Made for: Claude Code, Codex.

Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 693 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00063 $0.00693
Opus 5 $0.00032 $0.00347
Sonnet 5 $0.00013 $0.00139
Haiku 4.5 $0.00006 $0.00069

Measured 2d ago against content hash 7733ebf40a9d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

tui-development scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.codex/skills/tui-development/SKILL.md · 59 lines

How it starts

The opening of the file, as written. The whole thing — 59 lines — stays where its author put it; the contents beside it link to each section on GitHub.

TUI Development

Architecture Boundary

  • src/worldforge/harness/robotics_launch.py: launcher and host-owned viewer helpers.
  • src/worldforge/harness/robotics_view.py: Textual-free robotics report model and constants.
  • src/worldforge/harness/robotics_tui_rendering.py: pure Rich renderable builders for panes.
  • src/worldforge/harness/tui.py: robotics-showcase-only Textual import surface.
  • src/worldforge/harness/tui_styles.py and tui_robotics_styles.py: Textual CSS constants.

Never import Textual from worldforge.__init__, worldforge.cli, or non-TUI harness modules.

Robotics TUI Engineering Contract

  • Treat the robotics showcase as a testable report renderer first and a Textual screen second.
  • Keep robotics summaries and screen state JSON-native so evidence can move between CLI, tests, screenshots, and docs.
  • Keep long-running optional runtime work behind explicit commands; UI state should report progress and failure without hiding the underlying exception context.
  • The removed world-creation/provider/eval/benchmark harness screens must not come back through this skill. Use CLI/docs surfaces for those workflows.

Workflow

  1. Read robotics_view.py, robotics_tui_rendering.py, robotics_launch.py, and tui.py before touching TUI modules.
  2. Keep all Textual imports inside harness/tui.py.
  3. Keep report rendering pure and deterministic outside Textual so tests can run without the harness extra.
  4. Update the relevant tests: test_robotics_tui_rendering.py, test_robotics_showcase.py, test_robotics_showcase_scripts.py, or focused harness report tests.
  5. Update screenshots only when UI behavior or documented visual state changed.
  6. Validate with focused robotics tests, optional-import boundary checks, and the --extra harness coverage gate when behavior changes.

Definition Of Done

  • Robotics report rendering works without the harness extra.
  • Changed robotics UI behavior is covered at the pure-rendering level before TUI-specific tests.
  • Textual imports remain isolated and optional-import boundary checks pass when imports moved.
  • Snapshot or screenshot updates are intentional and tied to verified behavior.

Read the full file on GitHub · 59 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 59 lines · 63 tokens per session scan A 7733ebf40a9d

Subscribe to this mod's changes

tui-development is a skill published in the GitHub repository AbdelStark/worldforge (108 stars, last pushed 23d ago), licensed MIT. It adds 63 tokens to every session and 693 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

wellbeing

Proactive coaching across hydration, breaks, meals AND posture. Use when an [activity] event fires (message starts with [activity] Activity detected: . — labels include drink, break, celebrate, the fatigue label "yawning", or sedentary raw labels like "using computer"; sedentary events may also carry a…

autonomous-ai/autonomous-os · 124 tokens

faq

Explain how to run and use this repository's local Web UI, with detailed guidance for every Settings section and its visible controls. Use for questions about web development, Monitor, Setup, or Settings.

autonomous-ai/autonomous-os · 41 tokens

computer-use

Control the user's Mac via the paired Autonomous Buddy companion app — open/close apps, navigate URLs in Chrome, type text into focused fields, fire keyboard shortcuts, show desktop notifications, write to clipboard, click named UI buttons via macOS Accessibility. Also covers vision-driven tasks (screenshot…

autonomous-ai/autonomous-os · 211 tokens

connectors

Detect which third-party connectors (Gmail, Google Calendar, Google Drive, Notion, Figma, Asana, Linear, GitHub, Ahrefs, …) are connected to this device, and use them to answer or act for the user. Use when the user asks what's connected ("what connectors do I have", "is my gmail connected", "did I link figma"), or…

autonomous-ai/autonomous-os · 262 tokens

mood

Tracks the USER's mood only — signals + synthesized decision from camera/voice/telegram. Do NOT use for emotion commands directed at the device ("show sad", "be happy", bare "sad now"); those go through emotion/SKILL.md and are never logged here. Music/wellbeing skills consume the latest decision.

autonomous-ai/autonomous-os · 68 tokens

sensing-track

Query flow event logs to answer questions about past sensing events — "Have you seen anybody between 10pm and 12pm?", "Is there any motion in the last hour?", "What happened while I was away?".

autonomous-ai/autonomous-os · 48 tokens