SessionCast CLI - Control your agents from anywhere
npm install sessioncast-cliNode.js agent and CLI for SessionCast - a real-time terminal sharing platform.
sessioncast login - Browser-based OAuth login (recommended)sessioncast login - Authenticate with API key or agent tokensessioncast logout - Clear stored credentialssessioncast status - Check authentication statussessioncast agents - List registered agentssessioncast list [agent] - List tmux sessionssessioncast send - Send keys to a sessionsessioncast agent - Start the agent``bash`
npm install -g sessioncast-cli
Quick Install (PowerShell - Recommended):
`powershellDownload and extract itmux to C:\itmux
Invoke-WebRequest -Uri "https://github.com/itefixnet/itmux/releases/download/v1.1.0/itmux_1.1.0_x64_free.zip" -OutFile "$env:TEMP\itmux.zip"
Expand-Archive -Path "$env:TEMP\itmux.zip" -DestinationPath "C:\itmux" -Force
Manual Installation:
1. Download itmux v1.1.0
2. Extract to one of these locations:
-
C:\itmux (recommended)
- %USERPROFILE%\itmux
- Or set ITMUX_HOME environment variable
3. Verify: C:\itmux\bin\bash.exe should exist
4. Install CLI: npm install -g sessioncast-cliQuick Start
1. Get your agent token from app.sessioncast.io
2. Create config file
~/.sessioncast.yml:`yaml
machineId: my-machine
relay: wss://relay.sessioncast.io/ws
token: agt_your_agent_token_here
`3. Start the agent:
`bash
sessioncast agent
`4. View your sessions at app.sessioncast.io
Configuration
Create
~/.sessioncast.yml or ~/.tmux-remote.yml:`yaml
machineId: my-machine
relay: wss://relay.sessioncast.io/ws
token: agt_your_agent_token_hereOptional: API configuration
api:
enabled: true
agentId: "your-agent-uuid" exec:
enabled: true
shell: /bin/bash
workingDir: /home/user
defaultTimeout: 30000
llm:
enabled: false
`$3
-
SESSIONCAST_CONFIG - Custom config file path
- TMUX_REMOTE_CONFIG - Alternative config file pathUsage
$3
`bash
Run agent (foreground)
sessioncast agentRun agent (background)
nohup sessioncast agent > /tmp/sessioncast-agent.log 2>&1 &
`$3
`bash
Send text to a session
sessioncast send my-machine/dev "ls -la"Send special keys
sessioncast send my-machine/dev "Enter"
`Architecture
`
┌─────────────┐ WebSocket ┌─────────────┐ WebSocket ┌─────────────┐
│ Agent │ ◄─────────────────► │ Relay │ ◄────────────────► │ Viewer │
│ (Node.js) │ screen/keys │ (Server) │ screen/keys │ (Web) │
└─────────────┘ └─────────────┘ └─────────────┘
│
│ tmux
▼
┌─────────────┐
│ tmux │
│ sessions │
└─────────────┘
``The agent implements a circuit breaker pattern to prevent reconnection storms:
- Max reconnect attempts: 5
- Base delay: 1 second
- Max delay: 30 seconds (with exponential backoff + jitter)
- Circuit breaker duration: 2 minutes cooldown after max attempts
- Node.js >= 18
- tmux installed on the host machine
MIT License - see LICENSE for details.
- Homepage: https://sessioncast.io
- Email: devload@sessioncast.io