wingman-cli 0.3.0

AI-powered TUI coding assistant for the terminal

Wingman

AI-powered TUI coding assistant for the terminal. Your copilot for code.

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

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

Command	Description
/new	Start new chat
/rename <name>	Rename session
/delete	Delete session
/split	Split panel
/close	Close panel
/model	Switch model
/code	Toggle coding mode
/cd <path>	Change directory
/ls	List files
/ps	List processes
/kill <id>	Stop process
/history	View checkpoints
/rollback <id>	Restore checkpoint
/diff	Show changes
/compact	Compact context
/context	Context usage
/mcp	MCP servers
/memory	Project memory
/export	Export session
/import <file>	Import file
/key	API key
/clear	Clear chat
/help	Show help

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 License - see LICENSE for details.

Links

• Dedalus Labs
• Documentation
• Discord