# 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/)
