Skip to the guide

Glob in the terminal

Use the Glob CLI and full-screen TUI to capture notes, manage tasks, search, sync and work from scripts.

The Glob CLI lets you capture notes, manage tasks, search records and work from shell scripts. The accompanying full-screen terminal interface, or TUI, gives you a keyboard-driven list and detail view over the same CLI store.

Start with installation and updates. Then choose explicit commands for shell work or run glob to open the TUI.

Try the record commands

You can create and read records without an account session:

glob capture "Look up the train timetable" --tag travel
glob tasks add "Reserve tickets"
glob notes list
glob tasks list
glob search "train"

To write a note with a separate body:

glob notes new --title "Weekend trip" --body "Pack a raincoat and walking shoes." --tag travel

Use --json when you need complete IDs or structured output:

glob notes list --json
glob tasks list --json

The short IDs in human listings are for display. Commands that take a record ID require its complete UUID. The record reference explains every note, task, search and link command.

Open the full-screen interface

glob

Bare glob opens the separately installed glob-tui. The TUI calls the CLI for its data, so both use the same selected store. Press ? for help and q to quit. See the TUI guide and its complete key reference.

If only the command binary is installed, bare glob reports glob-tui is not installed. Explicit commands such as glob notes list still work. Rerun the bundled installer to restore the TUI.

Add account features

For hosted Ask Glob and account key management, configure the account service and sign in:

glob server set https://api.colli.dev
glob login --web
glob status

Sign-in also supports email and password or an existing account session token. The sync guide explains the separate sync passphrase and how to keep a Linux CLI store up to date.

Ask Glob receives the prompt you supply. It does not automatically read your CLI notes or tasks:

glob ask "Suggest a packing checklist for a wet weekend."

Understand the store

The CLI uses its own store, normally ~/.glob/store. It does not open the Mac application's database. Running glob login stores an account session; it does not download your records.

Use glob status to see the selected directory, server and whether a session is stored. Use glob doctor to open or create that store and report its health. Choose a different directory with --store on commands that accept it, or with GLOB_STORE_DIR. See configuration.

Check your platform

Local notes, tasks and search work on supported macOS and Linux builds. Hosted features need a connection, and Linux x86_64 needs the dynamic build for HTTPS. Node views and export require Linux; macOS does not include sync or relay.

Read availability and limits for the platform table, listing windows, search differences and transfer limitations.

Find a reference

You want to… Read
Find a command or flag Command directory
Install, update or fix PATH Installation
Select the store and service Configuration
Sign in or send a hosted AI question Sign in and Ask Glob
Capture, edit, complete or connect records Notes, tasks and links
Work inside a container or pin a node Views, pins and projects
Read or write Markdown Export and import
Synchronise a Linux store Sync and sharing
Manage API keys or recovery Keys and recovery
Keep a device available for Data API requests Running a relay
Automate commands Output and exit codes
Check platform and feature limits Availability and limits
Resolve an error Troubleshooting

For broader account features, see the account wiki. Product terms and data handling are described in the Terms and Privacy Policy. Contact [email protected] for product help and [email protected] for account issues.