tcp-serial 0.2.0

CLI tools for interacting with ser2net serial consoles over TCP

tcp-serial

CLI tools for interacting with ser2net serial consoles over TCP.

Installation

uvx tcp-serial

Or install permanently:

uv tool install tcp-serial

Usage

tcp-serial COMMAND [options]

Commands

monitor — continuously monitor serial console output

tcp-serial monitor --port 3000
tcp-serial monitor --ssh user@host --remote-port 3000 --reconnect --timestamp

exec — execute a command over the serial console

tcp-serial exec --port 3000 -- ls /tmp
tcp-serial exec --port 3000 --json -- uname -a
tcp-serial exec --ssh user@host --remote-port 3000 -- cat /proc/version

uboot — interrupt autoboot and enter the U-Boot prompt

tcp-serial uboot --port 3000 --from-shell
tcp-serial uboot --port 3000 --manual-reboot

Connection Options

All commands share these connection options:

Option	Description
--host	ser2net host (default: 127.0.0.1)
--port	ser2net TCP port
--ssh	SSH target for remote forwarding, e.g. user@host
--remote-port	ser2net TCP port on the SSH server
--remote-host	ser2net host as seen from the SSH server
--ssh-arg	extra argument passed to ssh (repeatable)
--encoding	text encoding (default: utf-8)
--mode	console mode: shell or uboot
--connect-timeout	max seconds to wait for connection (default: 5.0)

Use exactly one of --port (direct) or --ssh + --remote-port (SSH forwarding).

Environment Variables

Variable	Description
TCP_SERIAL_SSH	SSH target; overridden by --ssh
TCP_SERIAL_REMOTE_PORT	Remote port; overridden by --remote-port

License

MIT