How dtnewman/zev works
Project type and purpose
• Zev is a Python‐based CLI tool whose job is to translate natural‐language queries into shell commands by calling out to large language model (LLM) backends (OpenAI, Google Gemini, or Ollama). It is an open‐source utility focused on command discovery and safety checks.
File structure
• Top‐level:
• pyproject.toml, README.md, LICENSE, .github/workflows/publish.yml
• src/zev:
• main.py – the CLI entrypoint
• config/ – setup routines and typed config objects
• constants.py – global constants
• utils.py – helper routines (e.g. clipboard, formatting)
• llms/ – core abstraction (inference_provider_base.py, llm.py, types.py) plus three subfolders (gemini/, openai/, ollama/) each containing a provider adapter and a setup module.
README for additional insights
• Describes interactive vs direct‐query modes, supported providers, setup process, safety warnings, and dependencies (xclip, wl-clipboard) for clipboard integration.