Terminalwire apps are command-line applications that run on your workstation and connect to a Terminalwire server. They can be installed, run, and removed just like any other command-line application.

Terminalwire apps may be installed from the public directory or directly from a URL.

Terminalwire maintains an application directory of public apps that you can install. To see a list of available apps, run the following command.

Lists available apps

terminalwire apps

+---------+------------------------------------+----------------------------+

|Name     |Description                         |URL                         |

+---------+------------------------------------+----------------------------+

|TinyZap⚡️|An open-graph enabled link shortener|https://tinyzap.com/terminal|

+---------+------------------------------------+----------------------------+

The app can be installed with the following command.

Installs apps to ~./terminalwire/bin

terminalwire install tinyzap

For Terminalwire apps not listed in the directory, they may be installed by running the following command.

Installs apps to ~./terminalwire/bin/tinyzap

terminalwire install \

    --url https://tinyzap.com/terminal \

    --name tinyzap

This is helpful for testing apps before they’re added to the public directory or apps that are not listed in the public directory.

Once an app is installed, you can run it from the command line just like you would any other command-line app.

tinyzap

Commands:

  tinyzap help [COMMAND]  # Describe available commands or one specific command

  tinyzap links           # Manage links

  tinyzap login           # Login to TinyZap

  tinyzap logout          # Logout of your account

  tinyzap open            # Opens TinyZap.com in your browser

  tinyzap version         # Prints the version of the CLI

  tinyzap whoami          # Prints your current login information

If the app doesn’t run, it’s likely that the Terminalwire binary path is not in the $PATH environment variable. You can run the terminalwire setup verify command to check if the binary path is in the $PATH environment variable.

Terminalwire apps are installed in the ~/.terminalwire/bin directory. To see a list of installed apps, run the following command.

Lists apps in ~./terminalwire/bin

terminalwire list

When you no longer need an app and want to remove it from your workstation, uninstall it with the following command.

Removes terminalwire apps from ~./terminalwire/bin

terminalwire uninstall tinyzap

Terminalwire apps are executable files in ~/.terminalwire/bin on workstations that point to a Terminalwire server URL.

Here’s what tinyzap looks like:

!/usr/bin/env terminalwire-exec

url: "https://tinyzap.com/terminal"

When executed, the terminalwire-exec program reads the url key from the file, connects to the URL, streams the command to the server for interpretation, and returns the output to the user. For example, tinyzap links ls connects to https://tinyzap.com/terminal, streams ["tinyzap", "links", "ls"] to the server, which processes the command and returns the output to the user.