shell-integration

Featured

Interactive shell/TTY integration with tmux session management, shell command execution, and output capture in sidecar. Covers the tty package, key mapping, adaptive polling, cursor rendering, scrolling, paste handling, and inline editing. Use when working on shell integration, tmux features, command execution, or interactive mode.

AI & Automation 1,041 stars 80 forks Updated today MIT

Install

View on GitHub

Quality Score: 95/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Shell Integration Sidecar's interactive shell allows users to type directly into tmux sessions from within the TUI. It is NOT a terminal emulator -- tmux is the PTY backend, sidecar acts as an input/output relay. ## Package Structure ``` internal/tty/ # Shared tmux terminal abstraction tty.go # Core Model and State types keymap.go # Bubble Tea -> tmux key translation messages.go # Message types (CaptureResultMsg, PollTickMsg, etc.) session.go # tmux operations (send-keys, capture-pane, resize) polling.go # Polling interval constants and calculation cursor.go # Cursor rendering and position query paste.go # Paste handling (clipboard, bracketed paste) terminal_mode.go # Terminal mode detection (mouse, bracketed paste) output_buffer.go # Thread-safe buffer with hash-based change detection internal/plugins/workspace/ interactive.go # Workspace-specific interactive mode logic interactive_selection.go # Text selection in interactive mode view_preview.go # Rendering with cursor overlay and scroll offset mouse.go # Scroll handling types.go # InteractiveState type internal/plugins/filebrowser/ inline_edit.go # Inline editor mode using tty.Model handlers.go ...

Details

Author
marcus
Repository
marcus/sidecar
Created
7 months ago
Last Updated
today
Language
Go
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category