본문으로 건너뛰기
cccskills
무료GitHub에 공개

agent-tui

Automate terminal UI (TUI) apps with agent-tui for testing, inspection, demos, and scripted interactions. Use when automating CLI/TUI flows, regression testing terminal apps, verifying interactive behavior, or extracting structured text from terminal UIs. Also use when asked what agent-tui is, how it works, or to demo it. Do not use for web browsers, GUI apps, or non-terminal interfaces.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

napisani/proctmux
설치 방법 보기

포함된 파일(15)

  • SKILL.md3.0 KB
  • agents/openai.yaml379 B
  • references/assertions.md814 B
  • references/clarifications.md1.1 KB
  • references/command-atlas.md3.1 KB
  • references/decision-tree.md657 B
  • references/demo.md811 B
  • references/flows.md2.3 KB
  • references/output-contract.md1.1 KB
  • references/prompt-templates.md1.2 KB
  • references/recovery.md898 B
  • references/safety.md637 B
  • references/session-lifecycle.md1.3 KB
  • references/test-plan.md774 B
  • references/use-cases.md532 B

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

agent-tui

Quick start

  • Verify install: agent-tui --version
  • Install with npm i -g agent-tui (or pnpm add -g agent-tui, bun add -g agent-tui).
  • Alternate install: curl -fsSL https://raw.githubusercontent.com/pproenca/agent-tui/master/install.sh -o /tmp/agent-tui-install.sh && sh /tmp/agent-tui-install.sh or cargo install --git https://github.com/pproenca/agent-tui.git --path cli/crates/agent-tui.
  • If you used the install script, ensure ~/.local/bin is on your PATH.
  • Start a session: agent-tui run --format json <command> -- <args...>
  • Observe: agent-tui screenshot --format json
  • Act: agent-tui press Enter or agent-tui type "text"
  • Wait or verify: agent-tui wait "Expected text" --assert or agent-tui wait --stable
  • Cleanup: agent-tui kill

Core workflow

  1. Run the app with agent-tui run and capture session_id from JSON output.
  2. Take a fresh snapshot with agent-tui screenshot or agent-tui screenshot --format json.
  3. Decide the next action based on the latest snapshot.
  4. Act with press or type.
  5. Synchronize with wait --assert or wait --stable.
  6. Repeat from step 2 until the task finishes.
  7. Clean up with agent-tui kill.

Reliability rules

  • Re-snapshot after every action that could change the UI.
  • Never act on a changing screen; wait for stability first.
  • Verify outcomes with wait --assert instead of assuming success.
  • Always end runs with kill or sessions cleanup.

Session handling

  • Use --session <id> for every command if more than one session exists.
  • If you lose the session id, run agent-tui sessions and agent-tui sessions show <id>.

Live preview (optional)

  • Ask whether a live preview is desired.
  • Start preview: agent-tui live start --open
  • Stop preview when done: agent-tui live stop

Deep-dive references

  • Full CLI coverage and options: references/command-atlas.md
  • JSON output contract: references/output-contract.md
  • End-to-end command sequences: references/flows.md
  • Quick command selection: references/decision-tree.md
  • Session lifecycle and concurrency: references/session-lifecycle.md
  • Assertions and test oracles: references/assertions.md
  • Failure recovery playbook: references/recovery.md
  • Safety and confirmation prompts: references/safety.md
  • Clarification checklist: references/clarifications.md
  • Test plan template: references/test-plan.md
  • Demo script: references/demo.md
  • User prompt templates: references/prompt-templates.md
  • Minimal command sets by use case: references/use-cases.md
  • Explorer/replay automation skill: ../tui-explorer/SKILL.md

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

e2e-testing

무료

Use when adding, running, or debugging proctmux end-to-end integration tests, especially PTY/TUI behavior, terminal snapshots, unified/client modes, timing flakes, VT100 emulator limits, or files under tests/e2e and internal/testharness/e2e.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

napisani/proctmux112026년 10월 8일 업데이트

proctmux-config

무료

Use this skill whenever the user wants to create, edit, explain, validate, or troubleshoot a proctmux.yaml/procmux.yaml file, add or change proctmux processes, configure lifecycle behavior such as stop signals/on_kill/autostart, customize unified-mode layout/keybindings/style, or enable Makefile/package.json process discovery. Use it even when the user says this casually, such as "add my dev server to proctmux", "fix this proctmux config", "write a config for these services", or "what YAML option controls focus".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

napisani/proctmux112026년 10월 8일 업데이트

tui-design

무료

This skill should be used when designing terminal user interfaces, creating TUI layouts, choosing TUI color schemes, implementing keyboard navigation, building terminal dashboards, or working with any TUI framework. Activates on mentions of TUI design, terminal UI, Ratatui layout, Ink components, Textual widgets, Bubbletea views, terminal color palette, keybinding design, panel layout, split panes, terminal dashboard, box-drawing characters, sparklines, progress bars, modal dialogs, focus management, or terminal accessibility.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

napisani/proctmux112026년 10월 8일 업데이트

tui-feedback-loop

무료

Harness-first workflow for evaluating and improving terminal UIs through real interaction. Use this whenever the user wants to review a TUI experience, compare before/after behavior, identify UX friction, validate navigation or filtering flows, inspect visual stability, or turn observed interaction problems into concrete follow-up tests and improvement recommendations. Prefer this skill any time a TUI should be exercised through a reproducible PTY/session harness instead of only reading code.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

napisani/proctmux112026년 10월 8일 업데이트

zig-best-practices

무료

Use when reading or writing Zig files (.zig, build.zig, build.zig.zon).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

napisani/proctmux112026년 10월 8일 업데이트

napisani의 스킬 모두 보기

이 스킬의 문제 신고