Metadata-Version: 2.3
Name: wingman-cli
Version: 0.4.1
Summary: AI-powered TUI coding assistant for the terminal
Keywords: ai,coding,assistant,tui,terminal,cli,llm,gpt,claude,gemini
Author: Aryan Mahajan, Dedalus Labs
Author-email: Aryan Mahajan <aryan@dedalus.ai>, Dedalus Labs <oss@dedaluslabs.ai>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Terminals
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Dist: dedalus-labs>=0.1.1
Requires-Dist: textual>=0.50.0
Requires-Dist: rich>=13.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: orjson>=3.10
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0 ; extra == 'dev'
Requires-Dist: ruff>=0.14.0 ; extra == 'dev'
Requires-Dist: ty>=0.0.5 ; extra == 'dev'
Maintainer: Aryan Mahajan
Maintainer-email: Aryan Mahajan <aryan@dedalus.ai>
Requires-Python: >=3.10
Project-URL: Documentation, https://github.com/dedalus-labs/wingman#readme
Project-URL: Homepage, https://github.com/dedalus-labs/wingman
Project-URL: Issues, https://github.com/dedalus-labs/wingman/issues
Project-URL: Repository, https://github.com/dedalus-labs/wingman
Provides-Extra: dev
Description-Content-Type: text/markdown

# Wingman

<div align="center">
  <code>uv tool install wingman-cli</code>
</div>
<br>

<div align="center">
  <img src="assets/readme.png" alt="Ralph 'Wingman' Wiggum flying with Dedalus wings" width="720">
</div>

<div align="center">
  <em>AI-powered TUI coding assistant for the terminal. Your copilot for code.</em>
</div>

## 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)

```bash
uv tool install wingman-cli
```

<details>
  <summary><span style="color: #7a7a7a; font-style: italic;">Installing <code>uv</code></span></summary>

```bash
# 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
```

</details>

### Using pip

```bash
pip install wingman-cli
```

### Using pipx

```bash
pipx install wingman-cli
```

## Quick Start

1. **Run Wingman**:

   ```bash
   wingman
   ```

2. **Enter your Dedalus API key** when prompted

   - Get your key at [dedaluslabs.ai/dashboard/api-keys](https://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](https://dedaluslabs.ai/dashboard/api-keys)

### Optional: Faster Search (Recommended)

Install [fd](https://github.com/sharkdp/fd) and [ripgrep](https://github.com/BurntSushi/ripgrep) for significantly faster file operations:

```bash
# 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](LICENSE) for details.

## Links

- [Dedalus Labs](https://dedaluslabs.ai)
- [Documentation](https://docs.dedaluslabs.ai)
- [Discord](https://discord.com/invite/RuDhZKnq5R)

---

<div align="center">
  <sub>Dedalus Labs © 2026.</sub>
</div>

---
