Soon

🤖 Predict your next shell command based on history — like shell autocomplete, but MORE stupid

🐚 Shell-aware (supports Bash, Zsh, Fish)
📊 Shows your most used commands and analyzes patterns
🧠 Smart learning from command history
🔄 Easy update management and version checking
🌍 i18n support (EN/中文) (WIP)
💡 Designed for clarity — not an autocomplete tool, but a prediction assistant.

Soon

Install

Archlinux

paru -Sy soon

Cargo

cargo install soon

Python

pip install soon-bin

Usage

»»»» soon help
Predict your next shell command based on history

Usage: soon [OPTIONS] [COMMAND]

Commands:
  now                  Show the most likely next command
  stats                Show most used commands
  learn                Train prediction and analyze command patterns
  which                Display detected current shell
  version              Show version information
  update               Check for updates and show installation options
  show-cache           Show cached main commands
  show-internal-cache  Show internal cache commands
  cache                Cache a command to soon cache (for testing)
  help                 Print this message or the help of the given subcommand(s)

Options:
      --shell <SHELL>  Override shell type (bash, zsh, fish, etc.)
      --ngram <NGRAM>  Set n-gram size for prediction accuracy [default: 3]
      --debug          Enable debug output
  -h, --help           Print help
  -V, --version        Print version

Main Commands

Command	Description
`now`	Show the most likely next command
`stats`	Show most used commands
`learn`	Train prediction and analyze command patterns
`which`	Display detected current shell
`version`	Show version information
`update`	Check for updates and show installation options
`show-cache`	Show cached main commands
`show-internal-cache`	Show internal cache commands
`cache <NUM>`	Set cache size to `<NUM>` and refresh cache
`help`	Print this message or the help of subcommands

Options

Option	Description
`--shell <SHELL>`	Override shell type (bash, zsh, fish, etc.)
`--ngram <NGRAM>`	Set n-gram size for prediction accuracy (default: 3)
`--debug`	Enable debug output
`-h, --help`	Print help
`-V, --version`	Print version

Examples

Predict your next command (default ngram=3)

soon now

Analyze your command patterns and learn insights

soon learn

Check for updates

soon update

Show your most used commands

soon stats

Show cached main commands (default ngram=3)

soon show-cache

Show cached main commands with custom cache size (e.g., 10)

soon cache 10
soon show-cache --ngram 10

Set shell type explicitly (if auto-detect fails)

soon now --shell zsh

Enable debug output

soon now --debug

How cache works

The .soon_cache file always contains the latest N main commands (N = cache size).
Every time you run soon now, soon cache <NUM>, or soon show-cache, the cache is refreshed from your shell history.
The cache size is controlled by the <NUM> argument in soon cache <NUM> or by --ngram <NGRAM> option.