wingman-cli

Wingman CLI

A powerful AI-powered coding assistant that runs directly in your terminal. Wingman helps you with coding tasks by reading files, executing commands, editing code, and writing new files — all through natural conversation.

✨ Features

• Interactive TUI — Rich terminal interface with markdown rendering and syntax highlighting
• File Operations — Read, write, edit, and search files in your codebase
• Shell Integration — Execute shell commands with full output capture
• MCP Support — Extend functionality with Model Context Protocol servers
• Context Management — Automatic conversation compaction to handle long sessions
• Multi-Model Support — Works with OpenAI, Anthropic, and compatible APIs
• Rewind — Undo changes and restore previous states
• Skills — Define custom workflows and capabilities

📦 Installation

From Source

go install github.com/adrianliechti/wingman-cli@latest

Build Locally

git clone https://github.com/adrianliechti/wingman-cli.git
cd wingman-cli
go build -o wingman .

🚀 Quick Start

1. Set up your API key:

# For OpenAI (or any OpenAI-compatible API)
export OPENAI_API_KEY="your-api-key"

# Optional: custom OpenAI-compatible endpoint
export OPENAI_BASE_URL="https://your-api-endpoint/v1"

1. Run Wingman in your project directory:

wingman

1. Start chatting! Ask Wingman to help with coding tasks:

> Show me all TODO comments in this project
> Refactor the config package to use dependency injection
> Write tests for the agent module

⚙️ Configuration

Environment Variables

Alternative: Wingman Server

Project Configuration

Create an AGENTS.md file in your project root to provide context-specific instructions:

# Project Guidelines

- Use Go 1.25+ features
- Follow standard Go project layout
- Write tests for all new functionality

MCP Integration

Add a mcp.json file to integrate with MCP servers:

{
  "servers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"]
    }
  }
}

🛠️ Built-in Tools

Wingman comes with powerful built-in tools:

🎨 Modes

• Agent Mode — Full autonomous operation with tool execution
• Plan Mode — Planning and analysis without making changes

Toggle between modes using the keyboard shortcut displayed in the status bar.