codex-deck-terminal

Convert user goals into approval-gated terminal execution plans with structured tags.

8|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/asfsdsf/codex-deck --skill codex-deck-terminal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-deck-terminal
Source: https://github.com/asfsdsf/codex-deck/tree/main/skills/codex-deck-terminal
Command: npx skills add https://github.com/asfsdsf/codex-deck --skill codex-deck-terminal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn a terminal task into an approval-gated, controller-reactive execution plan using structured tagged markdown, reducing unsafe “run it now” behavior while keeping steps machine-parseable.

Core Features & Use Cases

  • Approval-first terminal planning: Proposes exactly one actionable command per plan reply and waits for explicit approval before execution.
  • Controller-reactive step protocol: Adapts plans based on structured execution feedback (success, failure, timeouts, and rejections) using stable step_id values.
  • Structured command proposals for terminal controllers: Uses <ai-terminal-plan>, <ai-terminal-step>, <ai-terminal-need-input>, and <requirement_finished> tags so a UI/controller can render executable step cards and capture outcomes.
  • Environment grounding: Uses controller-provided terminal context such as terminal id, cwd, shell, OS release, architecture, and platform without assuming a specific OS.
  • Use case: When a user asks for a multi-step environment setup (e.g., install prerequisites, verify versions, and run a smoke test), codify the sequence as an approval-driven plan that can recover and revise after failures.

Quick Start

Use the codex-deck-terminal skill to produce an approval-first terminal plan for your controller by requesting: "Plan the steps to set up my project and run a safe smoke test, proposing each command as a single, controller-approved terminal step."

Frequently Asked Questions about codex-deck-terminal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an approval-first terminal execution plan for multi-step shell commands?

To create an approval-first terminal execution plan, you convert user goals into structured, single-command steps that wait for explicit approval before execution. This enforces safe continuation by proposing exactly one actionable command block per reply.

What is controller-reactive step protocol for terminal workflow automation?

A controller-reactive step protocol adapts terminal execution plans based on structured feedback like success, failure, or timeouts. It uses stable step_id values to ensure reliable recovery and plan revision after command execution attempts.

How do I structure terminal commands for a UI controller to parse and execute safely?

You structure terminal commands using specific markdown tags like ai-terminal-plan and ai-terminal-step. This allows a UI controller to render executable step cards, capture outcomes, and parse actionable plan blocks machine-readable format.

Can I use environment context like cwd, shell, and OS release to ground terminal execution plans?

Yes, terminal execution plans can be grounded using controller-provided environment context such as cwd, shell, OS release, architecture, and platform. This ensures plans adapt accurately without assuming a specific operating system.

How do I handle failures and timeouts in a multi-step terminal setup workflow?

To handle failures and timeouts in a multi-step terminal workflow, the plan uses stable step_id-based recovery to adapt subsequent commands. It processes structured execution feedback to revise the plan safely after a rejection or error.

Do I need a specific terminal controller to run approval-gated command proposals?

You need a controller capable of parsing structured tagged markdown and providing environment grounding to use approval-gated command proposals. The controller captures execution outcomes and manages the interactive gating required for safe step continuation.