cmd-correct

Shell command correction models for the fix CLI. Fine-tuned Qwen3 models that correct typos, fix case errors, and translate natural language to shell commands.

Available Models

Model	Size	Base	Description
qwen3-correct-0.6B.gguf	378 MB	Qwen3-0.6B	Fast, lightweight (default)
qwen3-correct-1.7B.gguf	~1 GB	Qwen3-1.7B	Higher quality, more capable

Quick Start

Install the CLI

macOS (Homebrew):

brew tap animeshkundu/fix
brew install fix

From Source (Rust):

cargo install --git https://github.com/animeshkundu/fix --features metal  # macOS
cargo install --git https://github.com/animeshkundu/fix --features cuda   # Linux/Windows with NVIDIA
cargo install --git https://github.com/animeshkundu/fix                   # CPU only

Usage

# Basic correction
fix gti status
# Output: git status

# With shell override
fix --shell powershell Get-ChidItem
# Output: Get-ChildItem

# Switch to larger model
fix --use-model qwen3-correct-1.7B

# List available models
fix --list-models

Supported Shells

bash, zsh, fish, powershell, cmd, tcsh

Model Details

Training

• Method: LoRA fine-tuning with MLX on Apple Silicon
• Dataset: 135K synthetic examples (typos, case errors, natural language)
• Format: ChatML with <|im_start|> / <|im_end|> tokens
• Quantization: Q4_K_M with importance matrix

Prompt Template

<|im_start|>system
You are a shell command corrector for {shell}. Output only the corrected command.<|im_end|>
<|im_start|>user
{incorrect_command}<|im_end|>
<|im_start|>assistant

Example Corrections

Input	Output	Type
gti status	git status	typo
git remote -V	git remote -v	case
dcokre ps	docker ps	typo
I need to list docker images	docker images	natural language

Links

• CLI: github.com/animeshkundu/fix
• Website: animeshkundu.github.io/fix

License

Apache 2.0