Five Core Operations
From command lookup to interactive patching — zero context switching.
Forgot a command?
Need help understanding command output?
Want to patch a script?
Hunting webshells or malware?
Need a chatbot? Just eva.
01/05
Forgot a command?
Need help understanding command output?
pytest -q | eva analyse "Summarize the failures"
-> Found 2 failures in test_provider_fallback.py
[Analysis] API key missing for Groq fallback provider
Want to patch a script?
eva edit "add validation for empty provider names" --file src/eva/cli.py
-> Reviewable diff generated (+2 / -0)
[Patch] Press [y/N] to apply modifications safely
Hunting webshells or malware?
eva sec yara scan /var/www/html --recursive
-> Detected PhpWebshellGeneric in /var/www/html/webshell.php
[YARA Scan] high severity finding | Matched: eval(base64_decode(...))
Need a chatbot? Just eva.
eva chat --session refactor-router
-> Resumed session 'refactor-router'
[Memory] Loaded 14 history items, disk-backed cache active
eva work
eva analyse
eva edit
eva sec yara
eva chat
On file.
TECHNICAL ARCHITECTURE & SECURITY GUARANTEES SOURCED FROM EVA CORE REPOSITORY.
Provider Abstraction & Fallback
Routes requests across OpenRouter (default), Groq, Gemini, OpenCode Zen, and local Ollama / llama.cpp backends with automatic failover.
Local-Only Utilities
Commands like `eva find`, `eva tree`, `eva grep`, and `eva cache clear` execute locally using deterministic tools with zero LLM API calls.
Budget & Quota Tracking
Disk-backed tracking logs RPM and RPD usage locally to prevent silent quota exhaustion on free-tier provider limits.
.gitignore-Aware Context
Context collection automatically respects `.gitignore` boundaries and prunes heavy node_modules, build outputs, and binaries.
Security Hardening & Audit Chain
Pre-network secret redaction with Shannon entropy checks (H > 3.5), SHA-256 hash-chained tamper-evident audit logs, and opt-in sandboxed execution.
Declarative Workflow Engine
`eva workflow run` executes YAML-defined multi-step tasks with approval gates (`repo_health`, `dependency_audit`, `security_scan`).
Offline Local Models
Full support for Ollama and llama.cpp GGUF backends with automatic local fallback when cloud providers are unreachable or quota-exhausted.
Terminal Replay Subsystem
`eva replay` records and plays back interactive terminal sessions with automatic secret redaction at write time.
Privacy-First Opt-In Telemetry
Disabled by default (`telemetry_enabled = false`). Tracks provider latency and status codes only — zero prompt or code content recorded.
Git-Aware Diffs & Explanations
`eva changes`, `eva commit-message`, and `eva explain` analyze git diffs, clarify execution context, and generate clean conventional commits.
Reviewable Patch Generation
`eva edit` outputs standard multi-file unified diffs and waits for explicit user confirmation before applying modifications to disk.
System Diagnostics
`eva config doctor` audits keyring storage, API keys, provider endpoints, Python version, and system dependencies.
Rust-Accelerated File Walker
`eva-cli[fast]` installs `eva-fastwalk`, a Rust/PyO3 extension for hyper-fast directory traversal and file discovery, with automatic Python fallback.
Extensible Plugin System
Third-party packages register CLI commands, custom LLM providers, and workflow hooks via the `EvaPlugin` protocol and standard Python entry points.
Shell Auto-Completion
`eva --install-completion` sets up tab completion for Bash, Zsh, and Fish shells via Typer's built-in completion engine.