+1
Daily
5,600
stars
212
forks
42
watchers
47
prs
763
issues
288
releases
README
Overview
Clink combines the native Windows shell cmd.exe with the powerful command line editing features of the GNU Readline library, which provides rich completion, history, and line-editing capabilities. Readline is best known for its use in the Unix shell Bash, the standard shell for many Linux distributions.
For details, refer to the Clink documentation.
[!NOTE]
Starting Clink injects it into a cmd.exe process, where it intercepts a handful of Windows API functions so that it can replace the prompt and input line editing with its own Readline-powered enhancements.
Download
Downloads are available from the releases page.
See the issues page for known issues or to file new issues.
Feature Highlights
- Auto-Suggestions; Clink offers suggestions as you type based on history, files, and completions.
- Completions; Clink can complete words when you press Tab or Ctrl-Space (interactive completion list).
- Persistent History; Clink stores persistent history between sessions.
- Scriptable Prompt; You can customize the prompt dynamically with Lua scripts -- like in other shells -- but never before possible in cmd.exe!
- Colored Input Line; Your input is colored by context sensitive completion scripts.
- Command Line Editing Improvements; Clink supercharges the command line with new input editing commands and configurable key bindings.
- Auto-answering of the "Terminate batch job?" prompt.
- and much more!
Installation
You can install Clink by running the setup EXE file from the releases page.
Or by using winget and running winget install --id chrisant996.Clink -e.
Or by using scoop and running scoop install clink.
Or by downloading the ZIP file from releases page, and extracting the files to a directory of your choosing.
Usage
Once installed, there are several ways to start Clink.
1. If Clink is configured for autorun, just start cmd.exe and Clink is automatically injected and ready to use.
The setup EXE has an option "Autorun when cmd.exe starts". If you didn't use the setup EXE, or if you want to enable or disable autorun later, you can run clink autorun install or clink autorun uninstall to change the autorun configuration. Run clink autorun --help for more info.
2. To manually start, run the Clink shortcut from the Start menu (or the clink.bat located in the install directory).
3. To establish Clink to an existing cmd.exe process, use clink inject.
If the Clink install directory isn't in the PATH, then use install_dir\clink in place of clink to run Clink commands. Once Clink is injected into a cmd.exe process, then it automatically sets an alias so that you can simply use clink.
You can use Clink right away without configuring anything:
- Searchable command history will be saved between sessions.
- Tab and Ctrl-Space will do match completion two different ways.
- Press Alt-h to see a list of the current key bindings.
- Press Alt-Shift-/ followed by another key to see what command is bound to the key.
See GetTop issues
#907customizable keys for the suggestion list7 comments · 2026-10-05#917ERROR: Setting 'autosuggest.inline' not found.1 comments · 2026-11-10#901Plans regarding the Readline vs terminal-input-box libraries1 comments · 2026-09-08
Discussions
#905How do I trace performance of Lua scripts?3 comments · 2026-09-17#902Quick response to prompt gives unexpected results1 comments · 2026-09-10#894Allow inline suggestion (Right-arrow accept) while the Suggestion List (F2) is active1 comments · 2026-08-06#890Escape code text sizing protocol1 comments · 2026-07-21#882Differing completion behavior for git switch and checkout1 comments · 2026-06-22#874suggestionlist.autooff ?2 comments · 2026-05-28#872Suggestions list on demand2 comments · 2026-05-24#842any possibility to run a function before clink (cmd.exe) exits?3 comments · 2026-02-19
Latest release
v1.9.36 v1.9.36 2026-11-09- Fixed console.settitle to preserve an Administrator prefix, if present. - Fixed an edge case that could cache failed ahead/behind counts (regression introduced in v1.9.35). - Fixed 915; 500 ms startup delay in conhost on Windows 10 (regression introduced in v1.9.35). - Reduced logging noise in the clink.log file: - Suppress log entries about resetting mismatched stdout/stderr handles; it's normal and frequent, and doesn't need log entries. - Only log history statistics when trimming to fit history.max_lines or when compacting history to remove lines marked for deletion. - Log begin