skills.rest
marcus
marcusCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

shell-integration

Relay interactive shell input and capture output through tmux sessions.

1.0k|79|Updated Dec 26, 2025
Search Tags:#interactive#workspace#tmux#terminal#shell#workflows
One-click install
npx skills add https://github.com/marcus/sidecar --skill shell-integration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shell-integration
Source: https://github.com/marcus/sidecar/tree/main/.claude/skills/shell-integration
Command: npx skills add https://github.com/marcus/sidecar --skill shell-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Sidecar users need a tight, integrated interface to drive tmux-based shells without leaving the UI. This skill provides an interactive shell/TTY integration layer that relays input and captures output via tmux sessions, including cursor rendering and bracketed paste handling.

Core Features & Use Cases

  • Interactive shell relay: type commands directly into tmux sessions from Sidecar, with live output.
  • Cursor rendering and bracketed paste handling to preserve shell behavior.
  • Workspace and file browser integration for inline editing and workflow automation.

Quick Start

Launch Sidecar and start typing commands to interact with a tmux session from the integrated shell.

Frequently Asked Questions about shell-integration

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

FAQPage Schema
How do I run an interactive shell inside Sidecar using tmux?▼

You can run an interactive shell inside Sidecar by relaying input directly to tmux sessions, capturing live output through a Go-based TTY integration layer that manages terminal modes and adaptive polling.

What is the best way to manage tmux sessions from a terminal UI workspace?▼

The best way to manage tmux sessions from a terminal UI workspace is using an integration layer that handles cursor rendering and bracketed paste, preserving shell behavior while driving commands from the embedded interface.

Does Sidecar shell integration support inline editing and file browser workflows?▼

Yes, Sidecar shell integration supports inline editing and file browser workflows by connecting the interactive shell relay with workspace integration, enabling workflow automation directly within the terminal UI.

How does terminal mode detection work with embedded tmux shell sessions?▼

Terminal mode detection in embedded tmux shell sessions works by applying adaptive polling and a TTY model to identify the current terminal state, ensuring accurate real-time output capture and cursor rendering.

Can I type commands directly into a tmux session and see live output in Sidecar?▼

Yes, you can type commands directly into a tmux session and see live output in Sidecar through the interactive shell relay, which handles input and output capture with bracketed paste support.

Why does bracketed paste handling matter for terminal UI shell workflows?▼

Bracketed paste handling matters for terminal UI shell workflows because it preserves shell behavior by correctly interpreting pasted content, preventing accidental command execution when relaying input to tmux sessions.

Related Skills

Explore More Software Engineering Skills→
adiytharpansaadiytharpansa

tmux

Create and manage tmux sessions for automated interactive command execution.

Community
Intermediate
shanevshanev
76

tmux-task-runner

Run long-running tasks in detached tmux sessions with persistent logs.

Community
Advanced
marcusmarcus
1.0k

inline-editor

Enable inline text editing in the file browser preview pane via tmux-backed PTY.

Community
Advanced
zach-sourcezach-source

tmux-zsh

Configure and troubleshoot tmux and zsh with plugin management and vi-mode.

Community
Advanced