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.

The easiest way to install an app is its one-liner. Each app publishes an installer at its own subdomain that installs the Terminalwire client (if it isn’t already installed) and drops the app’s launcher on your $PATH:

Installs the client (if needed) and the ogplus app

curl -sSL https://ogplus.terminalwire.sh | bash

Restart your terminal (or source your shell rc file) and the app is ready to run by name.

If you already have the client and just want to add a launcher for a server URL—handy for testing an app before it’s published—use terminalwire-exec install:

Writes a launcher to ~/.terminalwire/usr/bin/ogplus

terminalwire-exec install ogplus https://opengraphplus.com/terminal

Once an app is installed, run it from the command line just like any other command-line app:

ogplus

Commands:

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

  ogplus link            # Manage links

  ogplus login           # Login to ogplus

  ogplus logout          # Logout of your account

  ogplus open            # Open in your browser

  ogplus site            # Manage sites

  ogplus version         # Prints the version of the CLI

  ogplus whoami          # Prints your current login information

If the app doesn’t run, the Terminalwire binary directory is likely not on your $PATH. Re-run the app’s installer, or add ~/.terminalwire/bin to your $PATH (see Installation).

Terminalwire keeps the engine and your apps in separate directories under ~/.terminalwire:

• ~/.terminalwire/bin — the Terminalwire client itself (terminalwire-exec and the terminalwire stub). A server can never write here.
• ~/.terminalwire/usr/bin — your installed app launchers (e.g. ogplus). This is the only directory an app install touches.

Both are added to your $PATH, with the engine directory taking precedence so an app can never shadow the client.

An app is just a launcher file, so removing it uninstalls the app:

Removes the ogplus launcher

rm ~/.terminalwire/usr/bin/ogplus

An app launcher is a small executable file in ~/.terminalwire/usr/bin that points at a Terminalwire server URL. Here’s what ogplus looks like:

!/usr/bin/env terminalwire-exec

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

When executed, terminalwire-exec reads the url key from the file, connects to the server, streams the command to the server for interpretation, and returns the output to you. For example, ogplus link ls connects to https://opengraphplus.com/terminal, streams ["ogplus", "link", "ls"] to the server, which processes the command and streams the output back to your terminal.