Please enable JavaScript to view this site.

Navigation: Take Command

Connection Manager

Scroll Prev Top Next More



This guide covers the connection-management and terminal features added to Take Command, including SSH and Serial connections.

 

•Serial Terminals

•SSH Connections

 

Profiles and Connection Manager

 

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.

 

Organizing profiles

 

•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.

 

Local profiles

 

A Local profile can specify its command, working directory, title, priority, user, password reference, font, color scheme, and elevated launch option.

 

WSL and container profiles

 

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.

 

Secrets vault

 

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.

 

Quick Connect and SSH

 

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.

 

SSH profiles

 

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.