Install and update

The Glob installer gives you glob, the command you use in a shell or script, and glob-tui, the full-screen terminal interface. You can capture and read notes and tasks without signing in. Sign in when you want to use account features such as hosted AI.

Choose your platform#

On Linux, static means the executable includes its native libraries. This lets the command run without installing those libraries separately, but the static build cannot use the system certificate store for HTTPS. Its local note, task and search commands still work. The TUI runs the same executable, so it has the same network limits.

The installer recognises x86_64 and amd64 as x86_64, and arm64 and aarch64 as arm64. It rejects 32-bit x86, including i386 and i686.

Before installing#

You need:

• A supported 64-bit Mac or Linux computer.
• Python 3 with its curses module for the terminal interface.
• curl, tar, and either sha256sum or shasum.
• A connection to the download service.

The default installation writes inside your home directory and does not need sudo. The installer requires python3 even when you intend to use only commands.

Install on macOS#

Run:

curl -fsSL https://install.colli.dev/install | sh
export PATH="$HOME/.local/bin:$PATH"
glob version

The installer downloads the archive for your computer, checks its SHA-256 checksum before unpacking it, then installs both interfaces. Look for Checksum verified. and Installed CLI + TUI in its output.

The export line adds the install directory to your current shell's command search path, called PATH. Add the same line to your shell profile if the installer says the directory is missing from PATH.

Install on Linux#

For local commands with the default static build:

curl -fsSL https://install.colli.dev/install | sh
export PATH="$HOME/.local/bin:$PATH"
glob version

For HTTPS account features on Linux x86_64, select the dynamic build:

curl -fsSL https://install.colli.dev/install | GLOB_INSTALL_DYNAMIC=1 sh
export PATH="$HOME/.local/bin:$PATH"
glob version

Put GLOB_INSTALL_DYNAMIC=1 next to sh, as shown. Putting it before curl sets it only for the download command and leaves the installer using its default selection.

The installer prints static beside the platform when it selects a static archive. On arm64 Linux it always selects static, even when GLOB_INSTALL_DYNAMIC is set.

Open Glob#

Check what is installed:

glob version
glob status
glob --help

glob version prints the CLI and protocol versions. glob status shows the selected store, whether a store file exists, the configured server and whether a session token is stored. A stored token does not by itself prove that the server still accepts the session.

Start the full-screen interface with either command:

glob
glob-tui

Bare glob looks for glob-tui beside its executable, then on PATH. Use a subcommand such as glob status for command mode. Read the terminal interface guide for navigation and shortcuts.

For account features, configure the normal Glob endpoint:

glob server set https://api.colli.dev

Then follow sign in. On Linux x86_64, use the dynamic installation above before signing in or syncing. You can also start with local commands.

Where the installer puts things#

Configuration, your session and your notes are separate from these installed program files. See configuration and storage.

Installer options#

Set these variables for the shell that runs the installer:

For example, install the executables into your own bin directory:

curl -fsSL https://install.colli.dev/install | GLOB_INSTALL_DIR="$HOME/bin" sh
export PATH="$HOME/bin:$PATH"
export GLOB_BIN="$HOME/bin/glob"
glob-tui

The TUI needs GLOB_BIN when the native command is outside ~/.local/bin/glob. Keep that export in your shell profile along with PATH. Finding the command on PATH alone does not tell the TUI which executable to use.

To inspect the installer before running it:

curl -fsSL https://install.colli.dev/install -o glob-install.sh

Open glob-install.sh in a text editor, then run it with sh glob-install.sh. You can prefix that command with the same installer variables.

Direct downloads and checksums#

The release downloads offer versioned archives. Choose the version and platform that match your computer:

Each archive has a matching .sha256 download. Before extracting a manually downloaded archive, calculate its SHA-256 with sha256sum on Linux or shasum -a 256 on macOS. The result must match the hash in its .sha256 file. The installer does this comparison automatically and refuses a mismatch.

For the normal installation, use the installer even if you have looked through the archives. It installs the command, both Python files and the TUI launcher together.

Update or reinstall#

Run the same installation command again. It replaces the installed command and terminal interface with the current published version. It does not remove your configuration, session or store.

Repeat any options you used before. In particular, Linux x86_64 users who need network features must repeat GLOB_INSTALL_DYNAMIC=1. A later run without that option selects the static build again. Repeat custom install directories too, or the installer writes to its normal locations.

You can use GLOB_INSTALL_VERSION to reinstall a particular published version. This selects program files only; it does not roll your data back to an earlier state.

Remove the programs#

For the default installation, sign out if you want to remove the saved session, then remove the program files:

glob logout
rm ~/.local/bin/glob ~/.local/bin/glob-tui
rm -r ~/.local/share/glob-tui

Adjust those paths if you chose custom directories. These commands leave your store and configuration in place. Keep them if you intend to reinstall. See configuration and storage to identify those locations.

If installation fails#

For other failures, see troubleshooting.