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 elicitation
• MCP Support — Extend functionality with Model Context Protocol servers
• Context Management — Automatic conversation compaction to handle long sessions
• Multi-Model Support — Works with any OpenResponses API compatible endpoint with auto-selection
• Rewind & Diff — Checkpoint-based undo with visual diff viewer
• Skills — Define custom workflows using Agent Skills format
• Image Support — Paste images from clipboard for vision-capable models
• File Context — Add files to context with @filename or /file command
• Theme Detection — Automatic light/dark theme based on terminal settings

📦 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 any OpenResponses API compatible endpoint
export OPENAI_API_KEY="your-api-key"

# Optional: custom endpoint (defaults to OpenAI)
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 Tab key.

⌨️ Keyboard Shortcuts

📝 Commands

🔧 Skills

Skills are reusable workflows defined in SKILL.md files. Wingman discovers skills from:

• .skills/
• .github/
• .claude/
• .opencode/

Example skill file (.skills/testing/SKILL.md):

---
name: run-tests
description: Run the project test suite with coverage
---

# Testing Skill

Run tests with: `go test -cover ./...`