ai-agent

zsh-autosuggestions: Complete Commands Faster

Name: zsh-autosuggestions: Complete Commands Faster
Author: zsh-users

Get instant command suggestions with zsh-autosuggestions, a must-have for founders working with zsh, with 36k+ GitHub stars

35,966 stars1,935 forksShellHealth Score 9/10Updated 6/24/2025100% free · open source

What it does

zsh-autosuggestions provides instant command suggestions as you type in your zsh terminal, drawing from your command history to suggest possible completions

Install / run

git clone https://github.com/zsh-users/zsh-autosuggestions.git; echo 'source /path/to/zsh-autosuggestions/zsh-autosuggestions.zsh' >> ~/.zshrc

When to use it

•When working with frequently used commands and wanting to reduce typing time
•When exploring a new system or project and needing to quickly find available commands
•When trying to recall complex or hard-to-remember commands

Quick start

1Clone the zsh-autosuggestions repository using git clone https://github.com/zsh-users/zsh-autosuggestions.git
2Add the source line to your ~/.zshrc file: echo 'source /path/to/zsh-autosuggestions/zsh-autosuggestions.zsh' >> ~/.zshrc
3Restart your terminal or run source ~/.zshrc to apply the changes
4Start typing a command and press the right arrow key to accept a suggestion
5Customize the suggestion color by adding the following line to your ~/.zshrc file: 'ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE="fg=12"'

Ready-to-paste prompt

Type 'git ' and then press the right arrow key to accept a suggested Git command, such as 'git status'

Heads up: Make sure you have zsh installed and set as your default shell, as zsh-autosuggestions only works with zsh and not with other shells like bash

Saves to your device

Topics

autocomplete

autosuggest

fish

shell

zsh

zsh-autosuggestions

How zsh-autosuggestions: Complete Commands Faster works

Codeflow

Free to inspect

Zsh-autosuggestions: Complete Commands Faster is a small Shell project (~1.4k lines across 14 code files, plus 27 test files). Setup is light: runs with Docker. Last commit 14 months ago, MIT license, has a test suite.

Size

Small codebase

~1.4k lines · 14 code files · 12 min skim

Setup

Light setup

Runs with Docker.

Runs on

Ruby · Docker

No API keys detected