Command Overview

Termiflow provides a simple set of commands designed to feel native to your terminal workflow. All commands support --help for detailed usage information.

$ termiflow --help
Command Description
ask Ask a question and get an AI-powered answer with sources
subscribe Subscribe to a topic for curated updates
unsubscribe Remove a topic subscription
feed Display curated feed items from subscriptions
topics List available predefined topics and current subscriptions
config View and modify configuration
version Show version and build information

ask

Core

Ask a question and get an AI-powered answer synthesized from multiple sources. Results are streamed to your terminal in real-time with source attribution.

Usage
$ termiflow ask <question> [flags]
Flags
Flag Type Description Default
--sources int Number of sources to retrieve and synthesize 5
--no-search bool Use LLM knowledge only, skip web search false
--save bool Save query and response to history false
--provider string LLM provider: openai, anthropic, or local config
Examples
# Basic question
$ termiflow ask "latest advancements in 3nm chip fabrication"
# Use more sources for comprehensive research
$ termiflow ask "compare TSMC N3 vs Intel 4" --sources 10
# Quick answer from LLM knowledge only
$ termiflow ask "explain rust's borrow checker" --no-search
# Use a specific provider
$ termiflow ask "EUV lithography challenges" --provider local

subscribe

Core

Subscribe to a topic for curated updates. You can subscribe to predefined categories or create custom free-form topics. Updates are fetched and curated by AI based on your chosen frequency.

Usage
$ termiflow subscribe <topic> [flags]
Flags
Flag Type Description Default
--hourly bool Get updates every hour false
--daily bool Get updates once per day true
--weekly bool Get updates once per week false
--sources string Comma-separated source types: tavily, rss, scrape all
Examples
# Subscribe to a predefined category
$ termiflow subscribe "silicon-chips"
# Custom topic with weekly updates
$ termiflow subscribe "RISC-V adoption in automotive" --weekly
# High-frequency updates for fast-moving topics
$ termiflow subscribe "rust async ecosystem" --hourly
# Only use RSS feeds as source
$ termiflow subscribe "kubernetes" --sources rss

unsubscribe

Remove a topic subscription. Your existing feed items for that topic are preserved unless you run a cleanup.

Usage
$ termiflow unsubscribe <topic> [flags]
Flags
Flag Type Description Default
--all bool Unsubscribe from all topics (requires confirmation) false
--force bool Skip confirmation prompt false
Examples
# Unsubscribe from a specific topic
$ termiflow unsubscribe "silicon-chips"
# Unsubscribe from everything
$ termiflow unsubscribe --all
# Force unsubscribe without confirmation (useful in scripts)
$ termiflow unsubscribe "old-topic" --force

feed

Core

Display curated feed items from your subscriptions. Items are sorted by relevance and recency, with AI-generated summaries and tags.

Usage
$ termiflow feed [flags]
Flags
Flag Type Description Default
--topic string Filter feed by subscription topic all
--today bool Show only today's items false
--week bool Show items from the past week false
--limit int Maximum number of items to display 20
--refresh bool Fetch new items before displaying false
--all bool Include already-read items false
Examples
# Show all unread items
$ termiflow feed
# Refresh and show today's updates
$ termiflow feed --refresh --today
# Filter by specific topic
$ termiflow feed --topic "silicon-chips"
# Get a quick summary (limit to 5 items)
$ termiflow feed --limit 5
# Review everything from the past week
$ termiflow feed --week --all

topics

List available predefined topics and your current subscriptions. Predefined topics come with curated sources and optimized search keywords.

Usage
$ termiflow topics [flags]
Flags
Flag Type Description Default
--available bool Show only predefined categories false
--subscribed bool Show only your active subscriptions false
Examples
# Show everything (subscriptions + available)
$ termiflow topics
# Browse available predefined categories
$ termiflow topics --available
# Check your current subscriptions
$ termiflow topics --subscribed

config

View and modify termiflow configuration. Configuration is stored in ~/.config/termiflow/config.toml. API keys can also be set via environment variables.

Usage
$ termiflow config [command]
Subcommands
Command Arguments Description
init — Interactive first-time setup wizard
get <key> Get a configuration value
set <key> <value> Set a configuration value
--edit — Open config file in $EDITOR
path — Print config file location
Examples
# First-time interactive setup
$ termiflow config init
# View current configuration
$ termiflow config
# Set OpenAI API key
$ termiflow config set providers.openai.api_key "sk-..."
# Get current default provider
$ termiflow config get general.default_provider
# Open config in your editor
$ termiflow config --edit

version

Display version information including build date, git commit, Go version, and platform.

Usage
$ termiflow version
# or
$ termiflow --version
Example Output
$ termiflow version
termiflow v0.1.0
Build: 2025-01-15
Commit: abc1234
Go: go1.22.0
Platform: darwin/arm64