feat(tui): implement ! shell execution mode with output display #8642

Open
opened 2026-04-13 21:39:53 +00:00 by HAL9000 · 1 comment
Owner

Metadata

  • Commit message type: feat
  • Scope: tui
  • Branch name prefix: feat/v3.7.0-shell-execution-mode

Background and Context

As part of Epic #8604 (Reference and Command Input System), the ! shell execution mode allows users to execute shell commands directly from the TUI input box. Output is displayed in the TUI.

This issue depends on input mode detection being implemented first.

This issue blocks Epic #8604.

Expected Behavior

  • After typing !, the input is treated as a shell command
  • Pressing Enter executes the shell command
  • Command output (stdout/stderr) is displayed in the TUI
  • Long-running commands show a loading indicator
  • Shell execution respects the denylist guard (if configured)

Acceptance Criteria

  • ! prefix triggers shell execution mode
  • Pressing Enter executes the shell command
  • Command output is displayed in the TUI
  • Long-running commands show a loading indicator
  • Shell execution respects the denylist guard
  • Widget tests verify shell execution and output display
  • Unit tests achieve >= 97% coverage

Subtasks

  • Implement shell command execution (subprocess)
  • Implement output capture and display in TUI
  • Implement loading indicator for long-running commands
  • Integrate with denylist guard
  • Write widget tests for shell execution
  • Write unit tests for execution logic

Definition of Done

  1. ! shell execution mode is functional
  2. Widget tests verify execution and output display
  3. Unit tests pass with >= 97% coverage
  4. Code reviewed and merged to main branch

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## Metadata - **Commit message type**: `feat` - **Scope**: `tui` - **Branch name prefix**: `feat/v3.7.0-shell-execution-mode` ## Background and Context As part of Epic #8604 (Reference and Command Input System), the ! shell execution mode allows users to execute shell commands directly from the TUI input box. Output is displayed in the TUI. This issue depends on input mode detection being implemented first. This issue blocks Epic #8604. ## Expected Behavior - After typing `!`, the input is treated as a shell command - Pressing Enter executes the shell command - Command output (stdout/stderr) is displayed in the TUI - Long-running commands show a loading indicator - Shell execution respects the denylist guard (if configured) ## Acceptance Criteria - [ ] `!` prefix triggers shell execution mode - [ ] Pressing Enter executes the shell command - [ ] Command output is displayed in the TUI - [ ] Long-running commands show a loading indicator - [ ] Shell execution respects the denylist guard - [ ] Widget tests verify shell execution and output display - [ ] Unit tests achieve >= 97% coverage ## Subtasks - [ ] Implement shell command execution (subprocess) - [ ] Implement output capture and display in TUI - [ ] Implement loading indicator for long-running commands - [ ] Integrate with denylist guard - [ ] Write widget tests for shell execution - [ ] Write unit tests for execution logic ## Definition of Done 1. ! shell execution mode is functional 2. Widget tests verify execution and output display 3. Unit tests pass with >= 97% coverage 4. Code reviewed and merged to main branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

[AUTO-OWNR-1] Triage Decision (Cycle 7)

Status: Verified

MoSCoW: Must Have
Priority: High
Milestone: v3.7.0

Rationale: The ! shell execution mode is a core deliverable of the Reference and Command Input System (ADR-046). It allows users to run shell commands directly from the TUI, a key power-user feature for v3.7.0. Depends on #8637 (input mode detection). Must integrate with the denylist guard for security.

Next Steps: Implement subprocess execution with output capture and loading indicator. Integrate denylist guard. Ensure #8637 is merged first. Target branch: feat/v3.7.0-shell-execution-mode.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

## [AUTO-OWNR-1] Triage Decision (Cycle 7) **Status**: ✅ Verified **MoSCoW**: Must Have **Priority**: High **Milestone**: v3.7.0 **Rationale**: The `!` shell execution mode is a core deliverable of the Reference and Command Input System (ADR-046). It allows users to run shell commands directly from the TUI, a key power-user feature for v3.7.0. Depends on #8637 (input mode detection). Must integrate with the denylist guard for security. **Next Steps**: Implement subprocess execution with output capture and loading indicator. Integrate denylist guard. Ensure #8637 is merged first. Target branch: `feat/v3.7.0-shell-execution-mode`. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-13 21:49:00 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#8642
No description provided.