Skip to content

🚧 (Alpha stage software) Library and tooling that supports remote filesystem and process operations. 🚧

Notifications You must be signed in to change notification settings

chipsenkbeil/distant

Repository files navigation

Crates.io Docs.rs CI RustC 1.70+

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

Installation

Unix

# 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 -q -O- https://sh.distant.dev | sh

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

Windows

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.

Usage

# Start a manager in the background
distant manager listen --daemon

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

License

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.