Metadata-Version: 2.4
Name: wingmen
Version: 0.6.25
Summary: A focused terminal workspace for collaborating with ACP coding agents.
License-File: LICENSE
Requires-Python: >=3.14
Requires-Dist: aiosqlite==0.22.1
Requires-Dist: click==8.4.0
Requires-Dist: notify-py==0.3.43
Requires-Dist: pathspec==1.1.1
Requires-Dist: pyperclip==1.11.0
Requires-Dist: rich==15.0.0
Requires-Dist: setproctitle==1.3.7
Requires-Dist: textual-diff-view==0.1.5
Requires-Dist: textual-speedups==0.2.1
Requires-Dist: textual[syntax]==8.2.7
Requires-Dist: typeguard==4.5.2
Requires-Dist: typing-extensions==4.15.0
Requires-Dist: xdg-base-dirs>=6.0.2
Description-Content-Type: text/markdown

# Wingmen

Wingmen is a focused terminal workspace for collaborating with one or more
[Agent Client Protocol](https://agentclientprotocol.com/) (ACP) coding agents.

## Install

```bash
uv tool install wingmen
# or: pip install wingmen
```

Wingmen requires Python 3.14 or later on macOS or Linux.

## Run

```bash
wingmen
```

On first launch, choose the agents for your roster. Later launches restore that
roster. To select a project directory, pass it to the command:

```bash
wingmen ~/projects/example
```

Launch a specific roster directly when needed:

```bash
wingmen run -a claude -a codex -a gemini ~/projects/example
```

Agents take turns sequentially. Click an agent beside the prompt to choose who
receives the next message. Press `Ctrl+C` to cancel work or quit; use
`Ctrl+Shift+P` to pause or resume a multi-agent relay.

See the [user manual](docs/USER_MANUAL.md) for all commands and controls.

## ACP agents

Wingmen bundles catalog entries for Claude Code, Codex, and Gemini CLI. To use
another ACP-compatible command:

```bash
wingmen acp "node /path/to/agent-acp.js" ~/projects/example
```

## Development

```bash
make verify
```

## License

Wingmen is licensed under [AGPL-3.0](./LICENSE). See
[COMMERCIAL_LICENSE.md](./COMMERCIAL_LICENSE.md) for commercial licensing.
