AI-powered TUI coding assistant for the terminal
Project description
Wingman
uv tool install wingman-cli
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
-
Run Wingman:
wingman
-
Enter your Dedalus API key when prompted
- Get your key at dedaluslabs.ai/dashboard/api-keys
-
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. 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cead9b7823cb0c792490a6a5c9de6f9518a580d940c600f5e88a32be2912a2b9
|
|
| MD5 |
10f909c2ffe97c78026b511173ad4a0f
|
|
| BLAKE2b-256 |
75ac6af225a64597e5a70daab43b43b887016a2b8172ab8e9c1e3276a95f60d5
|
Provenance
The following attestation bundles were made for wingman_cli-0.4.3.tar.gz:
Publisher:
release.yml on dedalus-labs/wingman
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
wingman_cli-0.4.3.tar.gz -
Subject digest:
cead9b7823cb0c792490a6a5c9de6f9518a580d940c600f5e88a32be2912a2b9 - Sigstore transparency entry: 813532968
- Sigstore integration time:
-
Permalink:
dedalus-labs/wingman@7e1a0a030c0c8bcfd9879853abaf98d40398913a -
Branch / Tag:
refs/heads/main - Owner: https://github.com/dedalus-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7e1a0a030c0c8bcfd9879853abaf98d40398913a -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f64e6af9a3106d72bb0d0113e9c62542c84158633b7e9c3e28cbc66279207ec
|
|
| MD5 |
78bb2954a84597c562bc9f70f4104083
|
|
| BLAKE2b-256 |
914c645f4492b453046ee08859a44bf9514e35df21bdffb37fca0b759f23ed9f
|
Provenance
The following attestation bundles were made for wingman_cli-0.4.3-py3-none-any.whl:
Publisher:
release.yml on dedalus-labs/wingman
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
wingman_cli-0.4.3-py3-none-any.whl -
Subject digest:
1f64e6af9a3106d72bb0d0113e9c62542c84158633b7e9c3e28cbc66279207ec - Sigstore transparency entry: 813532971
- Sigstore integration time:
-
Permalink:
dedalus-labs/wingman@7e1a0a030c0c8bcfd9879853abaf98d40398913a -
Branch / Tag:
refs/heads/main - Owner: https://github.com/dedalus-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7e1a0a030c0c8bcfd9879853abaf98d40398913a -
Trigger Event:
push
-
Statement type: