shell-integration

Featured

Interactive shell/TTY integration with tmux session management, shell command execution, control-mode output capture with polling fallback, native cursor rendering, lazy scrollback, selection, paste handling, and inline editing. Use when working on shell integration, tmux features, command execution, or interactive mode.

AI & Automation 1,069 stars 81 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 96/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. Tmux remains the PTY backend. Sidecar renders ordered control-mode bytes through the shared `tty.Model`, whose VT behavior is behind the `screenmodel` adapter rather than implemented in plugin code. ## Package Structure ``` internal/tty/ # Shared tmux terminal abstraction tty.go # Core Model and State types keymap.go # Bubble Tea -> tmux key translation messages.go # Owner/target/generation-scoped messages session.go # tmux operations (send-keys, capture-pane, resize) scheduler.go # Keyed fallback-poll generation ownership control_*.go # Session-keyed tmux -C transport and manager capture_range.go # Atomic bounded history capture cursor.go # Cursor positioning helpers paste.go # Paste handling (clipboard, bracketed paste) terminal_mode.go # Capture-fallback mode recovery output_buffer.go # Absolute, bounded live/history buffer editor_session.go # Shared inline-editor tmux lifecycle internal/plugins/workspace/ interactive.go # Workspace-specific interactive mode logic interactive_selection.go # Text selection in interactive mode terminal_viewport.go # Pure shared ...

Details

Author
marcus
Repository
marcus/sidecar
Created
8 months ago
Last Updated
2 days ago
Language
Go
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category