This guide covers the connection-management and terminal features added to Take Command, including SSH and Serial connections.
A profile stores the settings required to open a tab:
Profile type |
Use |
|---|---|
Local |
Starts a local command or shell. |
Serial |
Opens a configured COM-port terminal. |
SSH |
Starts Windows OpenSSH (ssh.exe) in a ConPTY terminal tab. |
WSL |
Opens an installed WSL distribution in a ConPTY terminal tab. |
Docker |
Runs a shell in a locally running Docker container using docker exec. |
Podman |
Runs a shell in a locally running Podman container using podman exec. |
Open Connections > Connection Manager to edit profiles. This opens the modeless Profiles Settings page, which is the authoritative profile editor. Profiles can also be launched from the existing profile menus.
•Give each profile a meaningful name.
•Use Group to organize related profiles. Grouped profiles remain available from the profile menus.
•Use Tab Tint and Title to visually distinguish environments.
•Profile changes apply to newly opened sessions. Existing sessions keep the settings used when they were created.
A Local profile can specify its command, working directory, title, priority, user, password reference, font, color scheme, and elevated launch option.
In Settings > Profiles, select WSL, Docker, or Podman, then choose Refresh / Discover and select a target. Discovery is explicit, not run when the page opens. WSL targets come from the current user's registered distributions. Docker discovery uses the local Docker named pipe, not the selected Docker context or DOCKER_HOST. Podman requires a default Podman machine connection to the local loopback address and uses its configured machine identity; remote Podman connections are rejected. Discovery stores the full immutable IDs of running containers. The runtime must be installed and reachable; stopped or removed targets cannot launch. Container tabs use /bin/sh through exec -it; the selected container must provide that shell.
These profiles launch through ordinary ConPTY tabs. They do not accept a custom startup command, Run As credentials, vault secret, or elevated launch override, and Take Command does not add mounts, agent forwarding, or credentials inside containers. A Podman machine uses its own configured identity to connect to that local machine. The target is checked again on launch. A WSL starting directory can be left blank (start at the distribution's home directory), or set to a path under \\wsl.localhost\<selected distribution>\ or \\wsl$\<selected distribution>\. Only that distribution's UNC path is mapped to an absolute Linux path. Windows drive paths and container starting directories are rejected rather than guessed or silently remapped.
Open Settings > Secrets to manage passwords and passphrases in a per-user DPAPI-protected vault outside TCMD.INI. Profile and startup-tab passwords can be stored there; SSH profiles can also record a passphrase-secret reference, but the selector does not automatically supply the passphrase to OpenSSH.
See the Secrets vault user guide for setup, rotation, deletion, migration, and security limitations.
Use Quick Connect when you do not need to save a profile. It opens an ephemeral SSH tab and does not persist the target.
Accepted targets:
host
user@host
user@host:port
user@[2001:db8::1]
user@[2001:db8::1]:2200
Enter the target when prompted, then complete any normal OpenSSH host-key, password, keyboard-interactive, or MFA prompt in the terminal. Quick Connect validates the target before it starts ssh.exe.
For repeat connections, create an SSH profile. The profile editor provides these connection settings:
•Host, port, and user.
•Initial remote directory.
•Password, private-key, keyboard-interactive, and agent authentication selections.
•Private-key path and vault-backed passphrase reference.
•Host-key policy and optional fingerprint.
•Profile group, title, and tab tint.
•Jump-host, keepalive, forwarding, X11, and agent-forwarding settings.
•Optional terminal behavior: cursor shape/blink, bell action, copy-on-select, multi-line paste confirmation, font fallback, ligatures, color scheme, background image, shell integration, and SIXEL/iTerm2 image options.
Take Command uses the Windows OpenSSH client in a ConPTY tab. This retains normal OpenSSH behavior and the Windows OpenSSH host-key database. It is a terminal-client integration, not a programmatic SSH API.
An unset terminal option inherits its global setting. Terminal columns, rows, and scrollback remain global settings and cannot be overridden by a profile.