#remote #process #file #ssh #networking #read #shell

bin+lib distant

Operate on a remote computer through file and process manipulation

59 releases

0.20.0 Jul 15, 2023
0.20.0-alpha.10 Jun 26, 2023
0.20.0-alpha.3 Nov 29, 2022
0.16.4 Jun 7, 2022
0.2.0 Jul 31, 2021

#1368 in Command line utilities

Download history 13/week @ 2024-02-14 84/week @ 2024-02-21 4/week @ 2024-02-28 21/week @ 2024-03-13 133/week @ 2024-03-27 134/week @ 2024-04-03

267 downloads per month


20K SLoC


Documentation | Discussion

Crates.io Docs.rs CI RustC 1.70+

🚧 (Alpha stage software) This program is in rapid development and may break or change frequently! 🚧



# Need to include -L to follow redirects as this returns 301
curl -L https://sh.distant.dev | sh

# Can also use wget to the same result
wget https://sh.distant.dev | sh

See https://distant.dev/getting-started/installation/unix/ for more details.


Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # Optional: Needed to run a remote script the first time
irm sh.distant.dev | iex

See https://distant.dev/getting-started/installation/windows/ for more details.


# Start a manager in the background
distant manager listen &

# SSH into a server, start distant, and connect to the distant server
distant launch ssh://example.com

# Read the current working directory
distant fs read .

# Start a shell on the remote machine
distant shell

See https://distant.dev/getting-started/usage/ for more details.


This project is licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or apache-license) MIT license (LICENSE-MIT or mit-license) at your option.


~1M SLoC