info

About

A high-performance hybrid Zsh+C autocomplete plugin with trie-based prefix matching, ghost text completion, and persistent storage. Features smart history navigation that filters commands by prefix and learns from your usage patterns.

flash_on
Lightning Fast
O(log n) trie-based prefix matching with C-powered performance
visibility
Ghost Text
Smart suggestions appear as you type with dim gray styling
filter_list
Prefix Filtering
Navigate only commands matching your current prefix
save
Persistent Storage
Commands cached between sessions for instant startup
cloud_download

Download

Get v1.0.0 Release

Download the complete packaged plugin with binaries and installation guide

download Download Plugin (v1.0.0)
check_circle Ready-to-use binary
check_circle Installation guide included
check_circle ~14KB compressed
play_circle_outline

Interactive Demo

Type in the terminal below to see ghost text suggestions in real-time. Try typing commands like git, npm, docker, or ls. Use ↑/↓ arrows for prefix-filtered history navigation, Tab or → to accept suggestions, and type clear or press Ctrl+L to clear the terminal.

info

Note: This is a simplified browser simulation to demonstrate the core concepts. The actual Zsh plugin is much more powerful, featuring C-powered trie data structures, persistent storage, frequency-based ranking, and real-time shell integration with sub-millisecond response times.

zsh - autocomplete demo
$
arrow_upward
Up Arrow
Previous matching command
arrow_forward
Right Arrow
Accept ghost suggestion
keyboard_tab
Tab
Accept ghost text
keyboard_return
Enter
Execute command
build

Installation

auto_awesome

Quick Install from Release (Recommended)

Download and extract the pre-built package with all binaries included:

wget https://github.com/sbeeredd04/zsh_plugin/releases/download/v1.0.0/zsh-autocomplete-v1.0.0.tar.gz
tar -xzf zsh-autocomplete-v1.0.0.tar.gz
cd zsh-autocomplete-v1.0.0
echo "source $(pwd)/plugin.zsh" >> ~/.zshrc
source ~/.zshrc
The package includes INSTALL.txt with complete setup instructions.
code

Build from Source

Step 1: Clone the repository
git clone https://github.com/sbeeredd04/zsh_plugin.git
cd zsh_plugin
Step 2: Build the system
make clean && make
Step 3: Add to your .zshrc
echo "source $(pwd)/plugin.zsh" >> ~/.zshrc
Step 4: Reload shell
source ~/.zshrc
help_outline

How to Use

keyboard

Basic Operations

arrow_upward
Up Arrow: Navigate to previous command matching prefix
arrow_downward
Down Arrow: Navigate to next command matching prefix
arrow_forward
Right Arrow: Accept ghost text completion
keyboard_return
Enter: Execute command and update usage statistics
keyboard_tab
Tab: Accept ghost text or trigger standard completion
tips_and_updates

Example Workflow

$ git status # Ghost suggestion appears
# Press → to accept or continue typing

$ git status # Type "t"
# Press ↑ to see history

$ git status # From history
$ git commit -m # Press ↑ again
$ git push # Press ↑ again
# Press ↓ to navigate back
settings

How It Works

Prefix-Based History Navigation
Type any prefix (e.g., "git") and press ↑/↓ to navigate only commands starting with that prefix. The system remembers your current position in filtered results.
Ghost Text Completion
As you type, the best matching command appears as a suggestion in dim gray. Press → (right arrow) to accept the ghost text. Suggestions are based on frequency and recency of usage.
Persistent Learning
All commands are stored in a trie structure for fast retrieval. Frequency tracking ensures better suggestions over time. Data persisted to data/trie_data.txt with no re-initialization between sessions.
speed

Performance

0ms
Startup Time
<5ms
Ghost Text Response
<10ms
History Filtering
~1MB
Memory (1000 cmds)