Distribution & Licensing

Ship and update your command-line app

Once your CLI works in development, two things get it onto your users’ machines: a license for the server, and an install command for the client.

Get a license

Terminalwire Server needs a license to run in production. Request one from your Terminalwire account with the URL of your app, or from the command line:

Core — free for personal use and small businesses
terminalwire license request https://example.com/terminal --product core
Pro — for commercial use
terminalwire license request https://example.com/terminal --product pro

Core is free for personal and non-commercial use. Pro ($1,299/year per site, up to 1,000 client users) covers commercial use, with no revenue reporting and nobody looking at your books. Requesting a paid license from the command line opens the browser to collect payment. Without a valid license, users see a warning when they run your app, so get one before you distribute.

Install with one line

The simplest way for users to install your app is a one-line script. It installs the Terminalwire client, wires up their shell, and installs your app:

curl -sSL https://my-app.terminalwire.sh | bash

Replace my-app with your app’s binary name.

List it in the directory

Register a distribution so users can install by name and find your app in the directory:

terminalwire distribution create my-app --url https://example.com/terminal

Then anyone can install it with:

terminalwire install my-app

Listed apps get a shareable install page on terminalwire.com/applications. To install a one-off without listing it, pass the URL directly:

terminalwire install --url https://example.com/terminal --name my-app

Either way the client drops a launcher at ~/.terminalwire/bin/my-app, and updates itself from then on; you ship changes by deploying your server.