Metadata-Version: 2.4
Name: picoclaw
Version: 2026.3.3
Summary: PicoClaw — lightweight agent plugin for CMDOP optimized for speed
Project-URL: Homepage, https://cmdop.com
Project-URL: Documentation, https://cmdop.com/docs/sdk/python/
Project-URL: Repository, https://github.com/commandoperator/cmdop-sdk-python
Project-URL: Bug Tracker, https://github.com/commandoperator/cmdop-sdk-python/issues
License: MIT
Keywords: agent,cmdop,fast,lightweight,minimal,picoclaw
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: cmdop
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# PicoClaw — Lightweight Remote Shell & AI Agent Client for Python

[![PyPI](https://img.shields.io/pypi/v/picoclaw.svg)](https://pypi.org/project/picoclaw/) [![Python](https://img.shields.io/pypi/pyversions/picoclaw.svg)](https://pypi.org/project/picoclaw/) [![license](https://img.shields.io/pypi/l/picoclaw.svg)](https://github.com/commandoperator/cmdop-sdk-python/blob/main/LICENSE)

![CMDOP Architecture](https://cmdop.com/images/architecture/vs-personal-agent.png)

PicoClaw provides a lightweight SSH alternative Python developers can use for minimal remote execution. Unlike SSH2, node-ssh, simple-ssh, and execa, PicoClaw offers a fast AI agent client and zero-config remote shell. Start scripting remote tasks and interacting with AI agents rapidly, bypassing complex setups.

## Features

- Execute remote commands with a lightweight SSH alternative Python interface.
- Enable minimal remote execution without complex configurations.
- Provide a fast AI agent client for quick interactions with remote AI models.
- Establish a zero-config remote shell for immediate access.
- Simplify remote file operations with a Pythonic API.

## Use Cases

- Execute shell commands on remote machines in one line
- Ask the AI agent questions and get instant answers
- Read and write remote files without SSH setup

## Installation

```bash
pip install picoclaw
```

## Quick Start

```python
from picoclaw import PicoClaw

client = PicoClaw.remote(api_key="cmdop_live_xxx")

uptime = client.run("uptime")
answer = client.ask("What is the most memory-hungry process right now?")

config = client.read("/etc/nginx/nginx.conf")
client.write("/tmp/backup.conf", config)

print(answer)
```

## CLI

No SDK needed? Connect via standalone binary:

```bash
curl -fsSL cmdop.com/install-cli.sh | bash
cmdok ssh
```

![cmdok ssh](https://raw.githubusercontent.com/commandoperator/cmdop-sdk-js/main/assets/cmdok-ssh.gif)

## Links

- [CMDOP Homepage](https://cmdop.com)
- [Documentation](https://cmdop.com/docs/sdk/python/)
- [picoclaw on PyPI](https://pypi.org/project/picoclaw/)
- [GitHub](https://github.com/commandoperator/cmdop-sdk-python)
