devptp

Early development: devptp is currently an alpha release. The IPC and networking APIs may change between versions.

devptp is a small peer-to-peer development networking utility. A Linux machine can serve selected local TCP services to a remote workstation through an iroh peer-to-peer connection. Windows clients and Linux aarch64 systems such as Asahi Linux can connect to a Linux serving machine.

• Peer-to-peer connectivity using iroh.
• Linux-only serving and automatic local port discovery.
• Configurable allowed ports.
• Local JSON IPC for automation and integrations.
• Linux x86_64, Linux aarch64 (including Asahi Linux), and Windows x86_64 release builds.

Optionally create .devptp.toml in the working directory:

shared_ports = [8083, 3000]

Only ports in shared_ports that are currently listening are advertised. If no configuration file is present, the daemon starts with no shared ports. You can also set DEVPTP_CONFIG to an explicit configuration file.

devptp --daemon

In another terminal, ask the daemon for a connection ticket:

devptp start-serving

The response is JSON containing the ticket:

{"id":1,"ok":true,"result":{"ticket":"..."}}

On the remote machine, start a daemon and connect with the ticket:

devptp --daemon
devptp connect --ticket '<ticket>'

The client receives and exposes the serving machine's available, configured ports. Use status to inspect the connection and forwarded ports.

The CLI prints the raw JSON IPC response, making it suitable for scripts.

The daemon uses a current-user-only local socket and newline-delimited JSON requests. The complete protocol, response shapes, method parameters, and examples are documented in docs/ipc-client.md.

Install the latest release on Linux x86_64 or Linux aarch64 (including Asahi Linux) with:

curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/SirMomster/devptp/main/scripts/install.sh | sh

The installer places devptp in ~/.local/bin. Set DEVPTP_INSTALL_DIR to install elsewhere. Windows users can install the latest release from PowerShell:

irm https://raw.githubusercontent.com/SirMomster/devptp/main/scripts/install.ps1 | iex

The PowerShell installer places devptp.exe in %LOCALAPPDATA%\devptp\bin. Set $env:DEVPTP_INSTALL_DIR to install elsewhere. You can also download the release .zip directly from GitHub Releases.

Run Cargo commands in the development container:

devcontainer up
devcontainer exec cargo build --release
devcontainer exec cargo test

For local cross-compilation from Linux, install Zig and cargo-zigbuild, then run:

./scripts/build-targets.sh

See CROSS_COMPILATION.md for supported targets. GitHub releases are generated automatically when a v* tag is pushed.

The current release is 0.1.2. The networking and IPC layers are implemented. The daemon is intentionally small: Linux handles service discovery and serving, while Windows is a connecting client. Additional forwarding policies can be added without changing the JSON IPC transport.

This project is licensed under the MIT License.