Sign inCreate account
Sign inCreate account

zev

From public sources

A simple CLI tool to help you remember terminal commands

AI toolCategory: AI ToolsOpen sourcedata checked Oct 16, 2026
Add to compareAdd to collection

Overview

  • cli
  • llm

Installation

Commands are shown, never run by the marketplace. Check them against the official documentation.
  • Language package registrypythonFrom public sourcesfrom the package manifest — publication on the registry is not verified
    pipx install zev

    Not verified: check that this package in the registry belongs to this project before installing.

    pypi.org/project/zev/ ↗
  • Build from sourceFrom public sourcesfrom catalog metadata

    Build from source: no validated build recipe — follow the repository instructions.

    github.com/dtnewman/zev ↗

Compatibility

Unknown means no evidence was found — not that the product is incompatible.
PlatformStatusArchitectureEvidenceConfidence
WindowsUnknown———
macOSUnknown———
LinuxUnknown———
Web browserUnknown———
Server / self-hostedUnknown———
Container (OCI)Unknown———
PythonCompatible—package manifest: pyproject.toml name0.60

Releases

checked Oct 30, 2026
No releases found on the source.

Quality profile

algorithm quality-v1.0 · assessed Oct 16, 2026
Quality Score68
Risk Score0
Confidence 1.00
Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 2012
last activity 120 days ago
Documentation · 1515
README 3775 chars, description present
Ready to use · 159
install instructions: yes; releases: no
Metadata · 108
3/4 of description, homepage, license, topics
Releases · 102
0 release(s)
Category confidence · 105
classifier confidence 0.5
Adoption · 107
720 stars (log-dampened, 10k = max)
License clarity · 55
SPDX MIT
Community · 55
issues enabled, 47 forks

License

MIT
Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/dtnewman/zevPrimary★ 720 starslast activity Jun 17, 2026Primary repository · Confidence 1.00

Reviews

Sign in to write a review

No reviews yet.

Alternatives

code2promptSimilar
A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting.MIT · AI Tools
openscienceSimilar
The open-source AI workbench for scientific researchApache-2.0 · AI Tools
oh-my-piSimilar
⌥ Coding agent with the IDE wired in. Built by Stencil Labs.MIT · AI Tools
SoupSimilar
Fine-tune LLMs from one YAML. Layer streaming trains an 8B model on a 4 GB laptop GPU.Apache-2.0 · AI Tools
apfelSimilar
The free AI already on your Mac. CLI tool, OpenAI-compatible server, and interactive chat — all on-device via Apple Intelligence. No API keys, no cloud, no downloads.MIT · AI Tools
opensrcSimilar
Fetch source code for npm packages to give AI coding agents deeper contextApache-2.0 · AI Tools

README

From dtnewman/zev · license MIT · fetched Oct 30, 2026

Zev 🔍

[PyPI version] [License: MIT]

Zev helps you remember (or discover) terminal commands using natural language.

[Description]

🔧 Installation

Homebrew (macOS)

brew tap dtnewman/zev
brew trust dtnewman/zev
brew install zev

pipx (linux)

pipx install zev
  • Note: This project runs on top of LLM APIs like OpenAI, Google's Gemini, or Ollama.

📦 Dependencies

For clipboard functionality (copying and pasting) to work properly, you may need to install:

  • On Linux: xclip or xsel (for X11) or wl-clipboard (for Wayland)
  • On macOS: No additional dependencies needed
  • On Windows: No additional dependencies needed

🎮 Usage

Option 1: Interactive Mode

zev

Option 2: Direct Query

zev '<what you want to do>'

📝 Examples

# Find running processes
zev 'show all running python processes'

# File operations
zev 'find all .py files modified in the last 24 hours'

# System information
zev 'show disk usage for current directory'

# Network commands
zev 'check if google.com is reachable'

# Git operations
zev 'show uncommitted changes in git'

🛡️ Safety Considerations

⚠️ Commands are generated by LLMs. While the tool attempts to flag dangerous commands, it may not always do so. Use caution.

[Example of dangerous command warning]

⚙️ Settings

Supported LLM Providers:

  • OpenAI
  • Google Gemini
  • Ollama
  • Azure OpenAI

You can update your API keys and provider settings by running:

zev --setup

OpenAI

To use OpenAI, you need an OpenAI account and a subscription. You can create an API key on this page.

Google Gemini (Free)

To use Google's Gemini models, you need a Google AI Studio account. You can create a Gemini API key in Google AI Studio.

🐪 Using with Ollama

You can use Zev with Ollama as an alternative to hosted providers, which lets you run all commands locally. To set this up:

  1. Install and start Ollama with a model of your choice

  2. Run zev --setup and put in the proper settings. For example:

? Pick your LLM provider: Ollama
? Enter the Ollama URL: http://localhost:11434/v1
? Enter the model to use (e.g. llama3.2): llama3.2

Azure OpenAI

To use Azure OpenAI, you’ll need access to an Azure OpenAI resource in your Azure subscription.

  1. Create a deployment of the model you want to use (e.g., gpt-5.4, gpt-5.4-mini etc.).

  2. Install required Azure depedencies with pipx install zev[azure].

  3. Run zev --setup and put in the proper settings. For example:

    ? Pick your LLM provider: Azure OpenAI
? Azure OpenAI account name (e.g. my-openai-resource): my-openai-resource
? Azure OpenAI API key (leave blank to use Entra ID / keyless auth):
? Azure OpenAI deployment name (e.g. gpt-5.4, gpt-5.4-mini, etc): gpt-5.4-mini
? Azure OpenAI API version: 2025-03-01-preview

    Note: Model version must be 2024-08-06 or newer.
    API version must be 2024-08-01-preview or newer.

Note that to switch backends, you can re-run zev --setup again at any time.

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Open the repository ↗