Skip to main content

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

  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

# 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

  1. Create folder: skills/your-skill/
  2. Add SKILL.md with 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zeer-0.1.0.tar.gz (38.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zeer-0.1.0-py3-none-any.whl (37.1 kB view details)

Uploaded Python 3

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

Hashes for zeer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 de248552ff2b2793003f55b8d79cacd2cda3c1df57a225d0678e6c10cf965242
MD5 3040d61d5609fe44d8da8075bf7d4176
BLAKE2b-256 f7c9971803bd2b16b545812664260759b4417d4191d3079635a7c8985a9b7ac5

See more details on using hashes here.

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

Hashes for zeer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3545df47d879501f31177b048ef7e72fcfef3153d25650afe55d6eb2b242e303
MD5 11f7875d3a1214b49f1e34d0b1cd6c91
BLAKE2b-256 a18771f224538f6b0bbead6dfc89fb8a20e24e919c2222d658fd0a0541312b1d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page