Woqu - Intelligent Command Assistant

A command correction tool inspired by thefuck, focusing on providing AI-powered suggestions through shell integration. Currently experimental and optimized for macOS environments.

Features

• 🍎 macOS First: Primary support for macOS 12+
• 🤖 AI Integration: DeepSeek and other OpenAI compatible providers
• ⚡ Swift Performance: Built with Swift 6.0
• ⚠️ Experimental: Core functionality stable but under active development

Installation

# Clone & Build
git clone https://github.com/ddrccw/woqu.git
cd woqu
swift build -c release

# Install to PATH
install .build/release/woqu /usr/local/bin/

Shell Integration

For bash users, add this to your ~/.bashrc or ~/.bash_profile:

eval "$(command woqu alias)"

Then either:

source ~/.bashrc  # or source ~/.bash_profile

or restart your terminal session.

Configuration

Create ~/.config/woqu/settings.yml:

# Required API credentials
defaultProvider: deepseek
providers:
  deepseek:
    apiKey: "redacted"
    apiUrl: "https://api.deepseek.com/chat/completions"
    model: "deepseek-chat"
    temperature: 0.7
  siliconflow:
    apiKey: "redacted"
    apiUrl: "https://api.siliconflow.cn/v1/chat/completions"
    model: "deepseek-ai/DeepSeek-V3"
    temperature: 0.7

TODO

• bash support ✔️
• fish support ✔️
• tcsh support
• Cross-platform support (Linux/Windows WSL)
• woqu config interactive configuration command
• Additional AI providers (Anthropic, Gemini, Azure OpenAI, etc.)
• Homebrew/Linuxbrew packaging

License

This code repository is licensed under the MIT License .