FAQ
General
Section titled “General”What is Enya?
Section titled “What is Enya?”Neovim meets Grafana, reimagined for human and agent collaboration. Enya is a keyboard-first multi-tool editor that brings together code, metrics, logs, traces, SQL, and terminals in one interface.
Why not just use Grafana?
Section titled “Why not just use Grafana?”Grafana is designed for broad audiences—dashboards that anyone can view. Enya is built for builders: engineers writing code, debugging production issues, and responding to incidents.
- Keyboard-first — Navigate your entire stack with vim-style keybindings
- Multi-tool — Code, metrics, logs, traces, SQL, terminals — all in one interface
- Codebase-aware — Jump from observability data directly to source code
- AI-native — Agents that understand your code, data, and infrastructure
- Local-first — Runs on your machine, works offline, no server required
Use Grafana for team-wide dashboards. Use Enya when you’re the one building, deploying, and on-call.
Is Enya free?
Section titled “Is Enya free?”Yes. Enya is open source and licensed under MIT.
Compatibility
Section titled “Compatibility”Which tools does Enya support?
Section titled “Which tools does Enya support?”- Prometheus compatible: Prometheus, Thanos, Cortex, Mimir, VictoriaMetrics
- Logs: Loki
- Traces: Tempo
- SQL: Apache DataFusion (Arrow Flight)
- Terminal: Ghostty (embedded)
- Custom: Create your own tools with Lua plugins
What platforms does Enya run on?
Section titled “What platforms does Enya run on?”- macOS — 10.15 (Catalina) or later
- Windows — Windows 10 or later
- Linux — AppImage, .deb, .rpm packages
- Web — WASM build runs in modern browsers (no Git integration or AI agents)
Workflow
Section titled “Workflow”Do I need to know vim to use Enya?
Section titled “Do I need to know vim to use Enya?”No, but it helps. Enya uses vim-style keybindings (h/j/k/l for navigation, : for commands), but you can also use arrow keys and the mouse. If you’re comfortable with vim or Neovim, you’ll feel right at home.
How does codebase integration work?
Section titled “How does codebase integration work?”Enya uses tree-sitter to parse your codebase and identify where metrics are defined. When you’re viewing a metric, press gd (go to definition) to jump to the source code.
Supported languages and frameworks:
- Rust — metrics-rs
- Go — prometheus/client_golang
- Python — prometheus_client
- TypeScript — prom-client
- JavaScript — prom-client
Can I use Enya with my existing Grafana dashboards?
Section titled “Can I use Enya with my existing Grafana dashboards?”Enya doesn’t import Grafana dashboards directly, but you can recreate your panels using Enya’s workspace TOML format. The PromQL queries work the same way.
How do AI agents work?
Section titled “How do AI agents work?”Enya uses ACP (Agent Client Protocol) to connect with AI agents. Supported agents:
- Claude Code — Anthropic’s coding agent
- Codex — OpenAI’s coding agent
Agents have access to the same commands you do, including your codebase, metrics, logs, traces, and SQL queries. They can answer questions like “Why is this metric spiking?” or “What logs correspond to this trace?”
Contributing
Section titled “Contributing”How can I contribute?
Section titled “How can I contribute?”Enya is open source. Visit the GitHub repository to:
- Report bugs
- Suggest features
- Submit pull requests
Where can I get help?
Section titled “Where can I get help?”- GitHub Issues — Bug reports and feature requests
- GitHub Discussions — Questions and community chat