Metadata-Version: 2.4
Name: pypith-cli
Version: 0.1.1
Summary: Wrap any CLI with agent-friendly progressive discovery
Project-URL: Homepage, https://github.com/ThomasRohde/pith
Project-URL: Repository, https://github.com/ThomasRohde/pith
Project-URL: Documentation, https://github.com/ThomasRohde/pith#readme
Project-URL: Changelog, https://github.com/ThomasRohde/pith/releases
Author-email: Thomas Klok Rohde <rohde.thomas@gmail.com>
License-Expression: MIT
Keywords: agent,ai,cli,command-line,llm,progressive-discovery,wrapper
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Shells
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: anthropic>=0.75.0
Requires-Dist: click>=8.0
Requires-Dist: pypith>=0.1.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: all
Requires-Dist: anthropic>=0.18; extra == 'all'
Requires-Dist: ollama>=0.1; extra == 'all'
Requires-Dist: openai>=1.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.18; extra == 'anthropic'
Provides-Extra: llm
Requires-Dist: anthropic>=0.75.0; extra == 'llm'
Requires-Dist: ollama>=0.6.1; extra == 'llm'
Requires-Dist: openai>=2.8.1; extra == 'llm'
Provides-Extra: ollama
Requires-Dist: ollama>=0.1; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai>=1.0; extra == 'openai'
Description-Content-Type: text/markdown

# pypith-cli

Wrapper CLI that turns existing tools into agent-friendly experiences.

- Capture help text, analyze it, and emit Pith schemas
- Generate Bash/PowerShell/CMD wrappers
- Optional LLM providers (Anthropic, OpenAI, Ollama) with heuristic fallback

## Installation

```bash
pip install pypith-cli

# With LLM providers
pip install pypith-cli[anthropic]
pip install pypith-cli[openai]
pip install pypith-cli[ollama]
```

## Quick Start

```bash
# Configure LLM provider (optional)
pith init --provider anthropic

# Wrap your tools
pith wrap kubectl terraform docker

# Activate in shell
eval "$(pith activate)"

# Now they're agent-friendly
kubectl                    # Shows progressive discovery tiers
```

## Commands

| Command | Description |
|---------|-------------|
| `pith init` | Configure LLM provider and settings |
| `pith wrap <tool>` | Wrap a CLI with progressive discovery |
| `pith unwrap <tool>` | Remove wrapper |
| `pith list` | List all wrapped tools |
| `pith refresh <tool>` | Re-analyze after tool upgrade |
| `pith activate` | Print PATH activation command |
| `pith find <query>` | Semantic search across tools |
| `pith export <tool>` | Export schema for sharing |
| `pith import <file>` | Import pre-made schema |
