Documentation

Get started in 60 seconds

1. Install

terminal
$ pip install sshdcommander

Requires Python 3.10+. Available on Windows and Linux.

2. Activate your license

terminal
$ sshdctl activate SSHDCMD-XXXX-XXXX-XXXX-XXXX --email [email protected]
License activated. Expires: 2027-04-03

Your license key is emailed after purchase. One active installation per key.

3. Configure your AI agent

Point your AI agent to the sshDCommander instructions so it knows how to use the CLI tools.

Option 1: Give your AI agent this prompt

Install sshDCommander (pip install sshdcommander) and run sshdcmd -? to learn the CLI. Read https://sshdcommander.com/docs/ai-instructionsfor full integration guidelines. Set up sshDCommander as the default SSH interface for this project — use sshdcmd for remote commands, sshdcp for file transfers, and sshdctl for server and daemon management instead of raw SSH, paramiko, or subprocess.

Or option 2: configure manually
A.Add the AI instructions URL sshdcommander.com/docs/ai-instructions to your CLAUDE.md or .cursorrules
B.Run sshdcmd -?and include the output in your agent's context
C.Read the documentation on this page for the full reference
The AI agent can take it from here — no need for steps 4–7 😊

4. Start the daemon

terminal
$ sshdctl start-daemon
Daemon started on 127.0.0.1:19222

5. Add a server profile

terminal
$ sshdctl server add --name prod -H 10.0.1.5 -u deploy --store
Server 'prod' added. Password stored in OS keyring.
$ sshdctl server set-default prod

5. Execute commands

terminal
$ sshdcmd --client-id me "uptime" --connect
Connected to 10.0.1.5:22 as deploy
14:32:01 up 42 days, 3:15, 0 users
$ sshdcmd --client-id me "df -h /"
Filesystem Size Used Avail Use% Mounted on
/dev/sda1 80G 24G 52G 32% /

The second command reuses the existing SSH connection. No reconnect.

6. Transfer files

terminal
$ sshdcp --client-id me upload ./release.tar.gz /opt/app/ --manifest deploy.json
SHA-256 verified release.tar.gz (24.7 MB) in 1.2s
$ sshdcp --client-id me verify deploy.json
All files verified. 1/1 passed.

7. When you are done

terminal
$ sshdctl done --client-id me
Session closed. Daemon running.

The daemon keeps running in the background. Next command reuses the connection instantly.

CLI Reference

sshdcmd

Execute remote commands.

sshdcmd --client-id NAME "COMMAND" [--server NAME] [--connect] [--script] [--timeout N]

sshdcp

Transfer files with integrity verification.

sshdcp --client-id NAME upload LOCAL REMOTE [--server NAME] [--manifest PATH]

sshdctl

Manage daemon, servers, and certificates.

sshdctl [start-daemon | connect | server add | ca init | done]

All tools support -? for comprehensive AI-friendly help output.