Skip to main content

AI-powered TUI coding assistant for the terminal

Project description

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

  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

License

MIT License - see LICENSE for details.

Links

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.2.1.tar.gz (35.5 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.2.1-py3-none-any.whl (39.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: wingman_cli-0.2.1.tar.gz
  • Upload date:
  • Size: 35.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wingman_cli-0.2.1.tar.gz
Algorithm Hash digest
SHA256 5d4e91e3b1871c4b46d83c95180c806952394e56480011c2d5f103d75270ff2e
MD5 1ee5186a8963f302231f30c237952e04
BLAKE2b-256 b1d85196a6591f0ec567c53f0a3f3274cd6c6e002a4039cbc4428ae292f795b7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: wingman_cli-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 39.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wingman_cli-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 41b48a5f98f2f4b50d07009a2a90f8b2207210168ff1f53a96485464fd811e06
MD5 74aa71fbe60f6cee1bddc392a5057a26
BLAKE2b-256 4ba11cd481bcf1a9bfe377d62e3831651c2f771d63de465e83f3a0bbc6c89928

See more details on using hashes here.

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