CLI Commands

remote-terminal provides a command-line interface for managing the server.

Commands

start

Start the web terminal, Telegram bot, and Tailscale tunnels.

remote-terminal start [options]

Options:

Flag	Description
`-w, --workspace <path>`	Workspace directory
`-p, --port <number>`	Web terminal port (default: 7860)
`--no-tailscale`	Skip Tailscale integration
`--no-telegram`	Skip Telegram bot

Examples:

# Start with defaults
remote-terminal start

# Custom workspace and port
remote-terminal start -w ~/myproject -p 8080

# Local only (no Tailscale)
remote-terminal start --no-tailscale

# Web terminal only
remote-terminal start --no-tailscale --no-telegram

expose

Expose a localhost port via Tailscale.

remote-terminal expose <port> [options]

Options:

Flag	Description
`--funnel`	Use Funnel (public) instead of Serve

Examples:

# Expose port 3000 on tailnet
remote-terminal expose 3000

# Expose publicly
remote-terminal expose 3000 --funnel

unexpose

Remove all Tailscale serve/funnel configurations.

remote-terminal unexpose

status

Show current status.

remote-terminal status

Output:

[remote-terminal] Workspace: /Users/you/project
[remote-terminal] Tailscale serve status:
https://your-machine.ts.net (tailnet only)
|-- / proxy http://localhost:7860

npm Scripts

# Start with Tailscale
npm start

# Start without Tailscale (development)
npm run dev