Metadata-Version: 2.4
Name: zeer
Version: 0.1.0
Summary: A beautiful, unified CLI for multiple AI providers with agent skills support
Author-email: M Aliyan <mahunxai@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/muhdaliyan/zeer
Project-URL: Documentation, https://github.com/muhdaliyan/zeer#readme
Project-URL: Repository, https://github.com/muhdaliyan/zeer
Project-URL: Issues, https://github.com/muhdaliyan/zeer
Keywords: ai,cli,openai,gemini,claude,agent,skills,chatbot
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.8
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
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: inquirer>=3.1.3
Requires-Dist: colorama>=0.4.6
Requires-Dist: prompt_toolkit>=3.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pyyaml>=6.0
Dynamic: license-file

# Zeer CLI ⚡

A beautiful, unified command-line interface for interacting with multiple AI providers (OpenAI, Gemini, and Claude).

## Features

### 🎨 Beautiful Interface
- Colorful ASCII art branding
- Color-coded messages and markdown rendering
- Clean, modern terminal UI with rich formatting
- Visual separators and tables

### ⌨️ Smart Input
- Autocomplete for slash commands
- Tab completion support
- Placeholder text hints
- Arrow key navigation in menus

### 🔧 Slash Commands
Use these commands during chat sessions:

| Command | Description |
|---------|-------------|
| `/models` | Switch to a different model |
| `/providers` | Switch to a different provider |
| `/skills` | List available agent skills (grid view) |
| `/tools` | List available tools (table view) |
| `/clear` | Clear conversation history |
| `/exit` | Exit the application |
| `/help` | Show available commands |

### 🛠️ Tool Calling & Agent Skills
- **File Operations**: Create, read, write, delete files
- **Code Execution**: Run Python code directly
- **Directory Management**: List, create, navigate directories
- **Agent Skills**: Modular capabilities following [agentskills.io](https://agentskills.io)
- **Progressive Disclosure**: Skills load on-demand to save context

### 🤖 Multi-Provider Support
- **OpenAI**: GPT-4, GPT-3.5-Turbo, and more
- **Google Gemini**: Gemini Pro, Gemini Flash
- **Anthropic Claude**: Claude 3 models

### 📦 Built-in Skills
- **pdf**: Create and generate PDF documents
- **code-helper**: Project setup and code organization
- **file-operations**: File system operations
- **text-processing**: Text file manipulation
- **frontend-designer**: Frontend development assistance

### 🔒 Secure & Smart
- API keys stored per provider
- Credentials persist across sessions
- Automatic cleanup on exit
- UTF-8 encoding support

## Installation

### From PyPI (Recommended)
```bash
pip install zeer
```

### From Source
```bash
git clone <repository-url>
cd zeer-cli
pip install -e .
```

## Usage

### Start the CLI
```bash
zeer
```

### Basic Workflow

1. **Select Provider**: Use arrow keys to choose OpenAI, Gemini, or Claude
2. **Enter API Key**: Input your API key (visible, stored securely)
3. **Select Model**: Choose from available models
4. **Start Chatting**: Type your messages and get responses

### Example Commands

```bash
# In chat:
> create a PDF of intro to Machine Learning
> list my files
> set up a Python project
> /skills    # View all skills in grid
> /tools     # View all tools in table
> /clear     # Clear conversation
```

## Agent Skills

Zeer follows the [agentskills.io](https://agentskills.io) specification for modular AI capabilities.

### Features
- **Progressive Disclosure**: Skills load only when needed
- **Scripts Support**: Include executable scripts in skills
- **References**: Add documentation files
- **Validation**: Automatic format checking

### Creating Custom Skills

1. Create folder: `skills/your-skill/`
2. Add `SKILL.md` with frontmatter:
```markdown
---
name: your-skill
description: What this skill does
allowed-tools: create_file read_file
---

## Goal
...
```

See [SKILLS_IMPLEMENTATION.md](SKILLS_IMPLEMENTATION.md) for details.

## Requirements

- Python 3.8+
- Internet connection for AI providers
- API keys for desired providers

## License

MIT License

## Links

- [Agent Skills Specification](https://agentskills.io)
- [PyPI Package](https://pypi.org/project/zeer/)
