Metadata-Version: 2.4
Name: acp-agent
Version: 0.0.1
Summary: A CLI tool to browse, search, and run ACP agents
Keywords: acp,agent,mcp,cli,agent-client-protocol
Author: observerw
Author-email: observerw <wozluohd@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: aioshutil>=1.6
Requires-Dist: attrs>=25.4.0
Requires-Dist: cyclopts>=4.5.1
Requires-Dist: httpx>=0.28.1
Requires-Dist: httpx-ws>=0.8.2
Requires-Dist: litestar>=2.19.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: pydantic>=2.12.5
Requires-Dist: rich>=14.3.2
Requires-Python: >=3.12
Project-URL: Repository, https://github.com/observerw/acp-agent
Description-Content-Type: text/markdown

# ACP Agent CLI 🚀

This project provides a friendly and intuitive Command Line Interface (CLI) for the [ACP Registry](https://github.com/agentclientprotocol/registry), enabling developers to quickly browse, search, and run ACP (Agent Client Protocol) agents locally.

## Motivation 💡

The official ACP Registry provides an extensive list of agents. This project aims to:

- **Instant Viewing**: Display all available agents in a beautiful terminal-based table.
- **Quick Discovery**: Support keyword-based fuzzy searching to find the right agent in seconds.
- **Local Execution**: Provide one-click run capabilities, automatically handling environment and parameter configurations to accelerate development and testing.

## Getting Started 🛠️

We recommend using [uv](https://github.com/astral-sh/uv) to manage and run this project.

### Basic Usage

```bash
uvx acp-agent --help
```

### Core Features

#### 1. List All Agents

Fetch and display the complete list of agents from the Registry:

```bash
uv run acp-agent list
```

#### 2. Search for Agents

Search by name or ID using keywords:

```bash
uv run acp-agent search opencode
```

```
Search Results for 'opencode'
┏━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID       ┃ Name     ┃ Description                  ┃
┡━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ opencode │ OpenCode │ The open source coding agent │
└──────────┴──────────┴──────────────────────────────┘
```

#### 3. Run an Agent Locally

Run an agent by its ID with support for argument passthrough and environment variables:

```bash
# Basic execution
uv run acp-agent run <agent-id>

# Run with a specific working directory and environment variables
uv run acp-agent run opencode --cwd ./my-project -e DEBUG=true
```

## License 📄

[MIT License](LICENSE)
