Installation

Get started with the Termiflow CLI. Our command-line interface provides a high-throughput, sovereign environment for real-time market data and system orchestration directly from your terminal.

Runtime
Go 1.24+
OS
Unix-Like / Win
Network
HTTPS (443)
01

Install CLI via Go

The primary way to install Termiflow is through the Go toolchain. This ensures you have the latest binary compiled for your specific architecture.

bash — install.sh
$ go install github.com/oluoyefeso/termiflow/cmd/termiflow@latest
... Downloading github.com/oluoyefeso/termiflow v—
... Successfully installed termiflow to $GOPATH/bin
01b

Alternative: Homebrew

Install a pre-built binary via Homebrew tap. Available on macOS and Linux.

bash — homebrew
$ brew install oluoyefeso/tap/termiflow
01c

Alternative: Claude Code

Paste the following into Claude Code and it will install and configure Termiflow for you.

claude code — prompt
Install termiflow via:
go install github.com/oluoyefeso/termiflow/cmd/termiflow@latest
Then run termiflow config init
and walk me through the setup.
02

Initialize Configuration

Once installed, initialize your local environment. This process creates the ~/.config/termiflow/config.toml file and verifies your API credentials.

termiflow — init
$ termiflow config init
Enter your termiflow API key: tf_xxxxxxxxxxxxx
Managed mode configured. No other keys needed.
[INFO] Config written to /users/root/.termiflow/config.yaml
03

Your First Feed

Subscribe to a topic and pull your first curated feed. The AI engine will score and rank results based on technical relevance.

termiflow — first run
$ termiflow subscribe rust-lang
Subscribed to rust-lang
$ termiflow feed
[SCANNING] Fetching latest from rust-lang...
[SCORING] Evaluating 42 entries...
[DONE] 8 items ready

Global Flags

FLAG DESCRIPTION DEFAULT
--verbose, -v Enable detailed logging output false
--config, -c Path to custom config file ~/.config/termiflow/config.toml
--format Output format [text, json, table] text
--quiet, -q Suppress non-essential output false

Watch Mode

Stream live updates to your terminal. Watch mode keeps your feed refreshing in real-time, perfect for a persistent terminal pane.

termiflow — watch
$ termiflow feed --watch
[WATCHING] Refreshing every 5 minutes...
[UPDATE] 3 new items found

Offline Mode

Access your cached feed without an internet connection. Termiflow stores all fetched data in a local SQLite database.

termiflow — offline
$ termiflow feed --offline
[OFFLINE] Reading from local cache (last sync: 2h ago)
[OK] 12 cached items available
PRO-TIP: CUSTOM PIPELINES
Chain termiflow outputs directly into grep or awk for automated filtering.
$ termiflow feed --format json | jq '.items[] | select(.score > 90)'