Home

Awesome

<h1 align="center"> <img src="https://distant.dev/assets/images/distant-with-logo-300x87.png" alt="Distant">

<a href="https://distant.dev/">Documentation</a> | <a href="https://github.com/chipsenkbeil/distant/discussions">Discussion</a>

</h1>

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.