sjs/vibetunnel
1
0
Fork 0
mirror of https://github.com/samsonjs/vibetunnel.git synced 2026-04-27 15:17:38 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
vibetunnel/tty-fwd
History
Mario Zechner 4757d27d26 Implement session-card architecture and improve session management 
- Create session-card component for individual session rendering
- Add Renderer active count tracking to monitor instance leaks
- Parse session ID from tty-fwd stdout for reliable session creation
- Add 2-second delay for fresh session connections to prevent race conditions
- Simplify session-list to use session-card components
- Restore original layout with controls and proper padding
- Improve SSE exit event handling with direct session ID usage

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-16 13:50:19 +02:00
..
src Implement session-card architecture and improve session management 2025-06-16 13:50:19 +02:00
.gitignore Initial changes for tty forwarding 2025-06-15 21:30:57 +02:00
build-universal.sh Remove control directory creation logic from TunnelServer 2025-06-16 07:36:30 +02:00
Cargo.lock Port to jiff 2025-06-16 00:28:29 +02:00
Cargo.toml Added universal binary build for tty-fwd 2025-06-16 02:04:43 +02:00
README.md Update readme 2025-06-16 01:25:37 +02:00

README.md

tty-fwd

tty-fwd is a utility to capture TTY sessions and forward them. It spawns processes in a pseudo-TTY and records their output in asciinema format while providing remote control capabilities.

Features

  • Session Management: Create, list, and manage TTY sessions
  • Remote Control: Send text and key inputs to running sessions
  • Output Recording: Records sessions in asciinema format for playback
  • Session Persistence: Sessions persist in control directories with metadata
  • Process Monitoring: Tracks process status and exit codes

Usage

Basic Usage

Spawn a command in a TTY session:

tty-fwd -- bash

Session Management

List all sessions:

tty-fwd --list-sessions

Create a named session:

tty-fwd --session-name "my-session" -- vim

Remote Control

Send text to a session:

tty-fwd --session <session-id> --send-text "hello world"

Send special keys:

tty-fwd --session <session-id> --send-key enter
tty-fwd --session <session-id> --send-key arrow_up

Supported keys: arrow_up, arrow_down, arrow_left, arrow_right, escape, enter

Cleanup

Remove stopped sessions:

tty-fwd --cleanup

Remove a specific session:

tty-fwd --session <session-id> --cleanup

Options

  • --control-path: Specify control directory location (default: ~/.vibetunnel/control)
  • --session-name: Name the session when creating
  • --session: Target specific session by ID
  • --list-sessions: List all sessions with metadata
  • --send-text: Send text input to session
  • --send-key: Send special key input to session
  • --cleanup: Remove exited sessions

License

Licensed under the Apache License, Version 2.0.