A beautiful, unified CLI for multiple AI providers with agent skills support
Project description
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
- 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)
pip install zeer
From Source
git clone <repository-url>
cd zeer-cli
pip install -e .
Usage
Start the CLI
zeer
Basic Workflow
- Select Provider: Use arrow keys to choose OpenAI, Gemini, or Claude
- Enter API Key: Input your API key (visible, stored securely)
- Select Model: Choose from available models
- Start Chatting: Type your messages and get responses
Example Commands
# 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 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
- Create folder:
skills/your-skill/ - Add
SKILL.mdwith frontmatter:
---
name: your-skill
description: What this skill does
allowed-tools: create_file read_file
---
## Goal
...
See SKILLS_IMPLEMENTATION.md for details.
Requirements
- Python 3.8+
- Internet connection for AI providers
- API keys for desired providers
License
MIT License
Links
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zeer-0.1.0.tar.gz.
File metadata
- Download URL: zeer-0.1.0.tar.gz
- Upload date:
- Size: 38.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de248552ff2b2793003f55b8d79cacd2cda3c1df57a225d0678e6c10cf965242
|
|
| MD5 |
3040d61d5609fe44d8da8075bf7d4176
|
|
| BLAKE2b-256 |
f7c9971803bd2b16b545812664260759b4417d4191d3079635a7c8985a9b7ac5
|
File details
Details for the file zeer-0.1.0-py3-none-any.whl.
File metadata
- Download URL: zeer-0.1.0-py3-none-any.whl
- Upload date:
- Size: 37.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3545df47d879501f31177b048ef7e72fcfef3153d25650afe55d6eb2b242e303
|
|
| MD5 |
11f7875d3a1214b49f1e34d0b1cd6c91
|
|
| BLAKE2b-256 |
a18771f224538f6b0bbead6dfc89fb8a20e24e919c2222d658fd0a0541312b1d
|