Eva

Ask your CLI directly.
Zero tab switching required.

Install Eva View Source

eva — zsh

[FIELD CASE EXHIBITS]

Four Core Operations

From command lookup to interactive patching — zero context switching.

EXHIBIT AREF. EVA-01

LOCAL SCOPE

Forgot a command?

EXHIBIT BREF. EVA-02

PIPED STDIN

Need help understanding command output?

EXHIBIT CREF. EVA-03

DIFF GENERATION

Want to patch a script?

EXHIBIT DREF. EVA-04

PERSISTENT SESSION

Need a chatbot? Just eva.

01/04

EXHIBIT AREF. EVA-01

LOCAL SCOPE

Forgot a command?

EXHIBIT BREF. EVA-02

PIPED STDIN

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

EXHIBIT CREF. EVA-03

DIFF GENERATION

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

EXHIBIT DREF. EVA-04

PERSISTENT SESSION

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 chat

[SYSTEM SPECIFICATIONS]

On file.

TECHNICAL ARCHITECTURE & SECURITY GUARANTEES SOURCED FROM EVA CORE REPOSITORY.

[PROV-FALLBACK]

Provider Abstraction & Fallback

Routes requests across OpenRouter (default), Groq, Gemini, OpenCode Zen, and local Ollama / llama.cpp backends with automatic failover.

[ZERO-QUOTA]

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.

[RPM-RPD-BUDGET]

Budget & Quota Tracking

Disk-backed tracking logs RPM and RPD usage locally to prevent silent quota exhaustion on free-tier provider limits.

[GIT-CONTEXT]

.gitignore-Aware Context

Context collection automatically respects `.gitignore` boundaries and prunes heavy node_modules, build outputs, and binaries.

[SEC-HARDENING]

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.

[WORKFLOW-ENGINE]

Declarative Workflow Engine

`eva workflow run` executes YAML-defined multi-step tasks with approval gates (`repo_health`, `dependency_audit`, `security_scan`).

[OFFLINE-BACKENDS]

Offline Local Models

Full support for Ollama and llama.cpp GGUF backends with automatic local fallback when cloud providers are unreachable or quota-exhausted.

[TERM-REPLAY]

Terminal Replay Subsystem

`eva replay` records and plays back interactive terminal sessions with automatic secret redaction at write time.

[OPTIN-TELEMETRY]

Privacy-First Opt-In Telemetry

Disabled by default (`telemetry_enabled = false`). Tracks provider latency and status codes only — zero prompt or code content recorded.

[DIFF-COMMIT]

Git-Aware Diffs & Explanations

`eva changes`, `eva commit-message`, and `eva explain` analyze git diffs, clarify execution context, and generate clean conventional commits.

[REVIEW-PATCH]

Reviewable Patch Generation

`eva edit` outputs standard multi-file unified diffs and waits for explicit user confirmation before applying modifications to disk.

[HEALTH-CHECK]

System Diagnostics

`eva config doctor` audits keyring storage, API keys, provider endpoints, Python version, and system dependencies.