Client features

Goauld client (tealc), the operator’s tool for connecting to and interacting with agents

The client, tealc, is the operator-facing tool used to connect to agents through the server: opening SSH sessions, forwarding proxies, transferring files, and managing agents.

Note

On every invocation, the client checks the server’s version and logs a warning if the server is running a newer version than the client. This is only a compatibility notice; it does not block the command from running.

This section covers the client’s features:

For task-oriented workflows, start with Operate Goauld.

Client authentication: how the client authenticates to the server and agents.
TUI: the text-based interface for monitoring and managing connected agents.
SSH: connecting to an agent’s shell.
Proxies: exposing an agent’s proxies locally.
SCP: transferring files with SCP, rsync, and rclone.
Jump: jumping to a target through an agent.
Clipboard: sharing the clipboard with an agent.
Shell logging: recording SSH sessions to a log file.
Audit mode: redacting sensitive information in the TUI.
ControlMaster: reusing SSH connections.
WireGuard: forwarding an agent’s WireGuard interface.
Compile agent: compiling new agents from the client.
Admin features: administrative operations available to the client.
Password: managing agent static passwords.
Embed server: embedding server connection details in a compiled agent.
Agent binding: binding an agent to specific hosts.
SOCKS: SOCKS proxy usage from the client.
VS Code: launching VS Code sessions against an agent.
Logs: retrieving recorded logs from an agent.
Forward: forwarding TCP ports, Unix sockets, or named pipes.
Shell completion: generating and installing tealc completion for zsh, bash, and fish.
Wait: waiting for an agent to come online.
Update: remotely upgrading an agent’s binary.
Persistent shell sessions: restoring shell sessions after an SSH disconnect.