Skip to main content

AI-powered TUI coding assistant for the terminal

Project description

Wingman

uv tool install wingman-cli

Ralph 'Wingman' Wiggum flying with Dedalus wings
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
Installing uv
# 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

  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

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 © 2026.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wingman_cli-0.4.3.tar.gz (51.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wingman_cli-0.4.3-py3-none-any.whl (59.2 kB view details)

Uploaded Python 3

File details

Details for the file wingman_cli-0.4.3.tar.gz.

File metadata

  • Download URL: wingman_cli-0.4.3.tar.gz
  • Upload date:
  • Size: 51.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for wingman_cli-0.4.3.tar.gz
Algorithm Hash digest
SHA256 cead9b7823cb0c792490a6a5c9de6f9518a580d940c600f5e88a32be2912a2b9
MD5 10f909c2ffe97c78026b511173ad4a0f
BLAKE2b-256 75ac6af225a64597e5a70daab43b43b887016a2b8172ab8e9c1e3276a95f60d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for wingman_cli-0.4.3.tar.gz:

Publisher: release.yml on dedalus-labs/wingman

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file wingman_cli-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: wingman_cli-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 59.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for wingman_cli-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1f64e6af9a3106d72bb0d0113e9c62542c84158633b7e9c3e28cbc66279207ec
MD5 78bb2954a84597c562bc9f70f4104083
BLAKE2b-256 914c645f4492b453046ee08859a44bf9514e35df21bdffb37fca0b759f23ed9f

See more details on using hashes here.

Provenance

The following attestation bundles were made for wingman_cli-0.4.3-py3-none-any.whl:

Publisher: release.yml on dedalus-labs/wingman

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page