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
• 🌍 i18n support (EN/中文) (WIP)
• 💡 Designed for clarity — not an autocomplete tool, but a prediction assistant.

Install

1. Archlinux

paru -Sy soon

2. Cargo

cargo install soon

3. Python

pip install soon-bin

Usage

»»»» soon help                                                                                                                                                                                      0|00:00:54
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 (WIP)
  which                Display detected current shell
  version              Show version information
  update               Update self [WIP]
  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>  
      --ngram <NGRAM>  [default: 3]
      --debug          Enable debug output
  -h, --help           Print help
  -V, --version        Print version

Main Commands

Options

Examples

Predict your next command (default ngram=3)

soon now

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.

MIT © 2025-PRESENT 简律纯.