Wingman

Features

• Multi-model support: OpenAI, Anthropic, Google, xAI, Mistral, DeepSeek
• Coding tools: File read/write, shell commands, grep, with diff previews
• MCP integration: Connect to Model Context Protocol servers
• Split panels: Work on multiple conversations simultaneously
• Checkpoints: Automatic file snapshots with rollback support
• Project memory: Persistent context per directory
• Image support: Attach and analyze images in conversations
• Context management: Auto-compaction when context runs low

Installation

Using uv (recommended)

uv tool install wingman-cli

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or via pip/pipx
pip install uv

Using pip

pip install wingman-cli

Using pipx

pipx install wingman-cli

Quick Start

1. Run Wingman:

   wingman
   

2. Enter your Dedalus API key when prompted

   • Get your key at dedaluslabs.ai/dashboard/api-keys

3. Start chatting - Type your message and press Enter

Commands

Configuration

Wingman stores configuration in ~/.wingman/:

~/.wingman/
├── config.json      # API key and settings
├── sessions/        # Chat history
├── checkpoints/     # File snapshots
└── memory/          # Project memory files

Supported Models

• OpenAI: GPT-4.1, GPT-4o, o1, o3, o4-mini
• Anthropic: Claude Opus 4.5, Sonnet 4.5, Haiku 4.5, Sonnet 4
• Google: Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0 Flash
• xAI: Grok 4, Grok 3
• DeepSeek: DeepSeek Chat, DeepSeek Reasoner
• Mistral: Mistral Large, Mistral Small, Codestral

Requirements

• Python 3.10+
• A Dedalus API key

Optional: Faster Search (Recommended)

Install fd and ripgrep for significantly faster file operations:

# macOS
brew install fd ripgrep

# Ubuntu/Debian
sudo apt install fd-find ripgrep

# Arch
sudo pacman -S fd ripgrep

Wingman automatically detects and uses these tools when available, falling back to find/grep otherwise.

License

MIT. See LICENSE for details.

Links

• Dedalus Labs
• Documentation
• Discord