Extensiones de FreeLens en 2026: catálogo completo y cómo instalarlas

Extensiones de FreeLens: la respuesta corta

FreeLens instala extensiones desde npm. Abre la página de Extensions (⌘⇧E en macOS, Ctrl+Shift+E en Linux y Windows), pega el nombre del paquete — por ejemplo @freelensapp/resource-map-extension — y pulsa Install. No hay un marketplace curado dentro de la app, así que el nombre del paquete es la dirección: lo obtienes del repositorio de la extensión, de su página en npm o de la tabla de más abajo.

Lectura relacionada: visión general e instalación de FreeLens.

Hay tres cosas con las que casi todo el mundo tropieza. Primero, FreeLens 2.0 rompió todas las extensiones 1.x: después de actualizar tienes que reinstalar cada extensión en su versión v2, y algunas extensiones de la comunidad todavía no la tienen. Segundo, @freelensapp/freelens-node-pod-menu está obsoleta y se distribuye como paquete vacío — esa funcionalidad se trasladó al propio FreeLens. Tercero, las extensiones de OpenLens y Lens no son compatibles sin más; varias se han portado, pero instalas el port para FreeLens, no el original.

Este catálogo está actualizado a fecha de FreeLens v2.1.0 (21 de noviembre de 2026), cuando la organización oficial freelensapp tenía 18 extensiones publicadas — el doble de las nueve que tenía en verano — más otras dos en camino. Si todavía estás decidiendo con qué cliente estandarizarte, consulta FreeLens vs OpenLens vs Lens.

Cómo instalar una extensión de FreeLens

  1. Abre FreeLens y ve a File → Extensions, o pulsa ⌘⇧E / Ctrl+Shift+E.
  2. Pega el nombre del paquete de npm en el campo de entrada — el nombre con scope completo, incluyendo el prefijo @freelensapp/ cuando aplique. El mismo campo acepta la URL de un release .tgz o una ruta en disco, para extensiones que no están publicadas en npm.
  3. Pulsa Install. FreeLens descarga el paquete desde el registro de npm (o desde un registro personalizado como Artifactory, si lo tienes configurado) y lo descomprime.
  4. Espera a que la extensión aparezca en la lista de instaladas con su interruptor Enabled activado. Una instalación sin checksum ni integridad de registro se marca como unverified y, desde la v2.1.0, se queda deshabilitada hasta que la activas tú mismo. Algunas extensiones añaden una nueva entrada en la barra lateral izquierda; otras añaden elementos de menú a vistas de recursos ya existentes, así que la ausencia de un icono en la barra lateral no significa que la instalación haya fallado.

Muchos README de extensiones publican también un enlace de un clic con el formato freelens://app/extensions/install/<package>, que abre FreeLens directamente en el diálogo de instalación con el nombre ya rellenado.

Las extensiones son por usuario, no por clúster: una vez instalada, una extensión está disponible para todos los clústeres de tu catálogo. Si una extensión necesita CRDs que un clúster determinado no tiene — las extensiones de Karpenter, KEDA o FluxCD, por ejemplo — sus vistas simplemente se quedan vacías en ese clúster en lugar de dar error.

FreeLens 2.0 rompió las extensiones 1.x

FreeLens v2.0.0, publicada el 28 de octubre de 2026, reconstruyó la app sobre Vite, ESM y React 19, y rediseñó la API de extensiones como un contrato congelado y especificado. Las notas de la versión son claras sobre la consecuencia: la nueva API no es compatible con las extensiones de v1. De ahí se derivan dos efectos prácticos.

  • Las extensiones antiguas muestran Failed to load. Una extensión creada para 1.x aparece listada pero no se ejecuta; su tooltip indica el proceso y el error.
  • No se migra nada. Las extensiones ahora viven bajo el directorio de datos de la aplicación en lugar de ~/.freelens/extensions, así que tras la actualización tu lista empieza vacía y tienes que instalar cada extensión de nuevo, en su versión 2.x.

Todas las extensiones oficiales de la siguiente sección declaran freelens: ^2.0.0 y Node 24 o superior. Para una extensión de la comunidad, revisa el campo engines.freelens de su package.json o su README antes de actualizar: algunas publican una línea separada por cada major (RabbitMQ 0.4.x y KubeSwift 0.x son las builds 1.x, por ejemplo), mientras que otras todavía no se han portado.

Extensiones oficiales de FreeLens

Estas viven bajo la organización de GitHub freelensapp y se mantienen junto con la propia app. Las versiones son las últimas en npm a fecha de 22 de noviembre de 2026; todas requieren FreeLens 2.0 o posterior.

Extensiónpaquete npmÚltima versiónQué te da
FluxCD@freelensapp/fluxcd-extension6.1.0Kustomizations, HelmReleases, GitRepositories y sources como vistas de primera clase, con el estado de reconciliación. La extensión más adoptada, con diferencia
Sveltos@freelensapp/sveltos-extension2.1.0Distribución de add-ons en flotas de clústeres
Kamaji@freelensapp/kamaji-extension2.0.1Control planes alojados y gestionados por Kamaji
Gateway API@freelensapp/gateway-api-extension1.0.0Gateways, HTTPRoutes y GatewayClasses — el sucesor de Ingress
Karpenter@freelensapp/karpenter-extension2.4.0NodePools, NodeClaims y decisiones de provisioning del autoscaler de nodos
KEDA@freelensapp/keda-extension2.0.2ScaledObjects, ScaledJobs y TriggerAuthentications, con triggers y eventos de scaling; pausa, escala a cero o reanuda desde el menú
GPU@freelensapp/gpu-extension1.0.0Uso de GPU por pod y por dispositivo, VRAM, consumo y desperdicio en idle, leído directamente del dcgm-exporter que ya tienes desplegado — sin DaemonSet, sin Prometheus
CloudNativePG@freelensapp/cnpg-extension2.0.0Clústeres de PostgreSQL gestionados por CloudNativePG: vista en vivo, backups, poolers, switchover y quorums de failover
Apache Kafka@freelensapp/kafka-extension2.0.0Una consola de Kafka dentro del IDE: topics, mensajes, consumer groups y brokers, autodescubiertos desde Strimzi o desde los workloads que usan MSK, Confluent Cloud, Aiven o Redpanda
RabbitMQ@freelensapp/rabbitmq-extension1.0.0Queues, exchanges, bindings, conexiones y mensajes a través de la Management API, de solo lectura por defecto
External Secrets@freelensapp/eso-extension2.3.1ExternalSecrets, PushSecrets y SecretStores con su estado de sincronización; fuerza una sync desde el menú
vals-operator@freelensapp/vals-extension1.0.0ValsSecrets y DbSecrets, con las referencias de origen y los leases de Vault detrás de cada Secret — solo metadatos, nunca los valores
Velero@freelensapp/velero-extension1.0.0Backups, restores, schedules y ubicaciones de almacenamiento con sus logs; de solo lectura hasta que habilitas la escritura
KubeSwift@freelensapp/kubeswift-extension1.0.0Todos los CRDs del runtime de VMs de KubeSwift: guests, imágenes, migraciones, snapshots y consolas
Resource Map@freelensapp/resource-map-extension2.0.0Grafo en vivo de fuerzas dirigidas con los recursos y sus relaciones. Portada desde el original de OpenLens
AI@freelensapp/ai-extension1.0.0Un asistente LLM dentro del IDE para explicar recursos y redactar manifiestos
Agent Bridge@freelensapp/agentbridge-extension2.1.0Una sesión por clúster del agente de código con IA que ya usas — OpenCode, Claude Code, GitHub Copilot CLI o Codex CLI
For Claude@freelensapp/for-claude-extension1.0.0Un chat por clúster impulsado por tu propia instalación de Claude Code, que actúa solo a través de herramientas de Kubernetes sujetas a permisos
Cluster API@freelensapp/capi-extensionno publicadaClústeres, machines y control planes de un management cluster de CAPI. En desarrollo: todavía nada en npm
cert-managerfreelens-cert-manager (por ahora)0.7.0Certificates, requests, issuers, órdenes y challenges de ACME, con renovación. Está pasando a formar parte de la organización; hasta que se publique ahí, instala el paquete original de Maifee Ul Asad
Node & Pod Menu@freelensapp/freelens-node-pod-menu1.1.0Obsoleta — paquete vacío, y solo para v1. No la instales

La organización también mantiene freelens-example-extension y freelens-extension-kit, pero son plantillas de andamiaje para escribir tu propia extensión, no algo que se instale.

Si usas Karpenter, la extensión encaja de forma natural con los trade-offs que vimos en Karpenter vs Cluster Autoscaler: ver cómo aparecen y se consolidan los NodeClaims en tiempo real hace que el comportamiento de disruption sea mucho más fácil de entender que leyendo eventos.

Para qué sirven las nuevas extensiones

Nueve de las extensiones oficiales aparecieron entre septiembre y noviembre de 2026. Se agrupan en cuatro bloques, y la mayoría sigue el mismo patrón: vistas de solo lectura por defecto, y cualquier escritura detrás de un diálogo de confirmación que lista las llamadas exactas a la API.

Bases de datos y mensajería: CloudNativePG, Kafka, RabbitMQ

Son las más ambiciosas del lote: consolas completas en lugar de simples visores de CRDs. La extensión de CloudNativePG cubre clusters, databases, roles, backups, poolers y una vista en vivo de lo que ocurre dentro de PostgreSQL, con switchover, fencing e hibernation como acciones confirmadas; nunca lee una credencial de base de datos. Kafka descubre los brokers a partir de los recursos de Strimzi o de los workloads que apuntan a un servicio gestionado, conecta las credenciales desde Secrets y hace port-forward por broker, de modo que topics, mensajes y consumer groups están a un clic. RabbitMQ hace lo mismo a través de la Management API y es de solo lectura por defecto.

Secrets y backup: External Secrets, vals-operator, Velero, cert-manager

La extensión de External Secrets muestra cada ExternalSecret con su store, su intervalo de refresh y su estado de sincronización, enlaza un Secret gestionado con su ExternalSecret y añade una opción de menú para forzar la sincronización. vals-operator hace lo equivalente para ValsSecret y DbSecret, incluido el lease de Vault detrás de las credenciales de base de datos generadas, y solo lee metadatos. Velero trae backups, restores, schedules y sus logs al IDE, y no escribe nada hasta que activas las escrituras para esa instalación. Una extensión de cert-manager se está trasladando a la organización; mientras tanto, el paquete original freelens-cert-manager ya funciona en FreeLens 2.

Autoscaling y GPUs: KEDA, GPU

KEDA lista ScaledObjects, ScaledJobs y TriggerAuthentications con sus triggers y sus eventos de scaling, y te permite pausar el autoscaling o escalar a cero desde el menú; un contexto útil junto con el autoscaling orientado a eventos con KEDA. La extensión de GPU es la de diseño más ingenioso: encuentra el dcgm-exporter (o cualquier exporter de GPU por proceso) que ya tengas en marcha y lo scrapea a través del pod proxy del API server, así que obtienes utilización por pod, VRAM, consumo y desperdicio en idle sin instalar nada en el cluster.

Plataforma: KubeSwift y Cluster API

KubeSwift cubre los 19 custom resources del runtime de VMs de KubeSwift, con acciones de ciclo de vida y consolas. Cluster API tiene repositorio y roadmap pero todavía ninguna release, así que no hay nada que instalar; la tabla la incluye para que sepas que está en camino.

Dos de las nueve originales cambiaron de sentido por el camino. For Claude llegó a la 1.0 y ahora es un frontend para tu propia instalación de Claude Code en lugar de un chat con API key, y Agent Bridge abre una sesión por cluster del coding agent que prefieras: OpenCode, Claude Code, Copilot CLI o Codex CLI.

Extensiones de la comunidad

Mantenidas por particulares ajenos a la organización principal. Son realmente útiles, pero comprueba dos cosas antes de depender de una: el número de versión (varias siguen en 0.x) y si se ha migrado a FreeLens 2. Algunas de las extensiones que eran populares en 1.x no se han migrado, y unas pocas nunca se publicaron en npm, así que instalas el .tgz desde sus releases de GitHub.

ExtensiónPaquete / origen¿Funciona en FreeLens 2.x?Qué te aporta
Argo@sebastian-prokesch/freelens-argo-extensionSí (2.0.0)Applications de Argo CD y Argo Rollouts (promote, abort), además de soporte inicial para Argo Workflows
Pod File Browser@thcraft/freelens-pod-file-browserSí (0.5.1)Navega por el filesystem de un pod (descarga, sube, edita, chmod) sin entrar con kubectl exec
Resource Filterfreelens-resource-filter-extensionSí (0.5.0)Filtrado por campos para cualquier kind, CRDs incluidos, con una preview en vivo tipo kubectl | jq
Envoy Gateway@maltazar/freelens-envoy-gateway-extensionSí (0.1.2)Policies y proxies de Envoy Gateway; complementa a la extensión oficial de Gateway API
Credential Explorerfreelens-credential-explorer (.tgz desde GitHub, no está en npm)No, solo 1.9+Salud y propiedad de Secrets: antigüedad, caducidad, y la cadena Secret → Deployment → Pods → ServiceAccount
Duplicate@omarluq/freelens-duplicate-extensionNo, solo 1.xDuplica un Pod, Deployment o StatefulSet en una copia de debug mediante el plugin de kubectl duplik8s
Workload Topologyfreelens-workload-topology (.tgz desde GitHub)No, solo 1.xVista de topología centrada en workloads en lugar de en todo el grafo de recursos
JobSet@mike-callahan/jobset-extension (.tgz desde GitHub)No, solo 1.xRecursos JobSet, relevantes para workloads de batch y ML

Dos extensiones que antes eran de la comunidad —External Secrets y KEDA, de Nídio Dolfini— han pasado a formar parte de la organización oficial. Los paquetes antiguos sin scope, freelens-eso-extension y freelens-keda-extension, siguen existiendo en npm; instala los @freelensapp/, que son la línea mantenida.

Detectar tokens, certificados y secrets caducados

Es lo más habitual que la gente busca resolver con una extensión, y hasta hace poco el FreeLens base no lo hacía: la vista de Secrets te mostraba que un Secret existía, no si lo que había dentro había caducado.

FreeLens v2.1.0 cerró la mayor parte de esa brecha en la app core. Los detalles de un Secret ahora listan los certificados que contiene en PEM —subject, issuer, nombres DNS y direcciones IP, número de serie y validez— y marcan la caducidad cuando está próxima o ya ha pasado. El parseo ocurre en el proceso principal, y las extensiones pueden reutilizar esa misma vista de certificados para sus propios recursos.

Para credenciales que no son certificados, las extensiones oficiales cubren el resto: External Secrets muestra cuándo se sincronizó por última vez cada secret y cuáles están fallando, y vals-operator muestra el lease y la caducidad de las credenciales de base de datos emitidas por Vault. Credential Explorer (freelens-credential-explorer), la extensión de la comunidad construida alrededor de la antigüedad y caducidad de los Secret y la cadena Secret → Deployment → Pods → ServiceAccount, sigue siendo una prueba de concepto 0.1.x para FreeLens 1.9 y versiones 1.x posteriores — no cargará en 2.x.

Uses la que uses, trata el IDE como una vista rápida de triaje y no como tu sistema de alertas — la respuesta duradera es una alerta de cert-manager o una regla de Prometheus sobre certmanager_certificate_expiration_timestamp_seconds, que te despierta a las tres de la madrugada cuando un IDE de escritorio no puede.

Por qué freelens-node-pod-menu ya no hace nada

Las primeras versiones de FreeLens se lanzaron sin los menús contextuales de node y pod que los usuarios de OpenLens esperaban — abrir una shell en un pod, hacer cordon a un node, ver logs desde el menú contextual. El hueco lo cubrió una extensión aparte, @freelensapp/freelens-node-pod-menu, y casi todas las guías de migración escritas en 2025 te dicen que la instales.

Esa funcionalidad desde entonces se ha absorbido en el propio FreeLens. El paquete sigue existiendo en npm, ahora marcado como no soportado, pero es un paquete vacío que no aporta nada — y, como paquete 1.x, ni siquiera cargará en FreeLens 2. Si seguiste una guía antigua y te preguntas por qué la extensión aparece instalada pero no añade ninguna función visible, esta es la razón — y los menús que buscabas ya están en la app core. Desinstálala y a otra cosa.

¿Puedes instalar extensiones de OpenLens o Lens?

No directamente. FreeLens hizo fork de OpenLens, así que la API de extensiones partió muy relacionada, pero los paquetes se publican por separado y no hay garantía de que una extensión original de Lens cargue. Desde FreeLens 2.0 la brecha es mayor: una extensión tiene que apuntar a la API v2 y a React 19, así que incluso un port de FreeLens 1.x necesita otra pasada. En la práctica, buena parte de las extensiones populares de OpenLens ya se han portado —el mapa de recursos es el ejemplo obvio— y el patrón es buscar un paquete con sabor freelens- en vez de forzar el original.

Si la extensión de la que dependes no tiene port, hacer un fork y adaptarla es una tarde de trabajo realista allá donde la licencia lo permita. El proyecto publica freelens-example-extension como plantilla de referencia, una guía de migración v1 → v2, y freelens-extension-kit, un método para construir una extensión con un agente de código con IA. Es una diferencia significativa respecto a Lens Desktop, donde la restricción es el licenciamiento de los binarios y no el código.

Cuando una extensión no se instala

  • No pasa nada al pulsar Install. Revisa el nombre del paquete carácter a carácter — el scope importa, y @freelensapp/keda-extension y freelens-keda-extension son dos paquetes distintos. El nombre de npm es la referencia autorizada, no el nombre del repositorio en GitHub, y algunas extensiones de la comunidad ni siquiera están en npm: instala su .tgz en su lugar.
  • Muestra Failed to load. Casi siempre es una extensión 1.x sobre FreeLens 2. Instala su versión 2.x, o espera a que el mantenedor la porte.
  • Se instaló pero se queda deshabilitada. Se instaló sin verificar — sin checksum junto al archivo y sin integrity en los metadatos del registro. Desde v2.1.0 esas esperan a que las habilites tú en la página de Extensions.
  • La extensión se instala pero sus vistas están vacías. Casi siempre son CRDs que faltan en ese cluster. Las extensiones de FluxCD, Karpenter, KEDA, Velero, Gateway API, Sveltos y Kamaji no renderizan nada útil contra un cluster que no ejecuta el controlador correspondiente.
  • Se instaló pero no añadió ninguna entrada en el sidebar. No todas las extensiones añaden una; algunas solo extienden paneles de detalle y menús contextuales ya existentes.
  • Funcionaba antes de una actualización y ahora no. Las extensiones de la comunidad siguen las releases de FreeLens de forma laxa. Fija la versión de FreeLens si una extensión es crítica para tu flujo de trabajo, y revisa el rango engines.freelens declarado por la extensión antes de actualizar la app.

Preguntas frecuentes

¿Cómo instalo extensiones en FreeLens?

Abre la página de Extensions con ⌘⇧E en macOS o Ctrl+Shift+E en Linux y Windows, pega el nombre del paquete npm de la extensión (por ejemplo @freelensapp/fluxcd-extension) y pulsa Install. El mismo campo también acepta la URL de un release .tgz o una ruta local, que es como se instalan las extensiones que no están en npm. No hay un marketplace donde navegar, así que lo que necesitas es el nombre del paquete.

¿Mis extensiones de FreeLens 1.x funcionan en FreeLens 2?

No. FreeLens v2.0.0 (octubre de 2026) rediseñó la API de extensiones y no es compatible con las extensiones de v1; aparecen como Failed to load. Las extensiones también se movieron a un nuevo directorio y no se migran, así que tras actualizar tienes que reinstalar cada una en su versión v2. Todas las extensiones oficiales de @freelensapp ya tienen una; varias extensiones de la comunidad todavía no.

¿Cuántas extensiones oficiales de FreeLens hay?

Dieciocho publicadas bajo la organización freelensapp a noviembre de 2026, desde FluxCD, Karpenter y Gateway API hasta otras más recientes para KEDA, GPUs, CloudNativePG, Kafka, RabbitMQ, External Secrets, vals-operator, Velero y KubeSwift. Dos más —Cluster API y cert-manager— tienen repositorio pero todavía ningún release bajo la organización.

¿Las extensiones de OpenLens y Lens funcionan en FreeLens?

No tal cual. FreeLens surgió como fork de OpenLens, pero los paquetes se publican por separado y, desde FreeLens 2.0, la API de extensiones se ha distanciado aún más: una extensión tiene que apuntar a la API v2 y a React 19 para cargar. Busca un port a FreeLens: muchas extensiones populares de OpenLens, incluido el resource map, ya tienen uno.

¿Por qué la extensión freelens-node-pod-menu no hace nada?

Porque está deprecada y se distribuye como un paquete vacío. Existía para recuperar los menús contextuales de nodo y pod que las primeras versiones de FreeLens no tenían; esa funcionalidad ya se ha integrado en el core de la app, y el paquete nunca se adaptó a la API v2. Guías de migración antiguas siguen recomendando instalarla: puedes desinstalarla sin problema, los menús ya están ahí.

¿Puede FreeLens mostrar cuándo caducan los Secrets o los certificados?

Sí, de forma nativa desde la v2.1.0: el detalle de un Secret lista los certificados que contiene —subject, issuer, DNS names, validity— y marca la caducidad cuando está próxima o ya ha pasado. Las extensiones de External Secrets y vals-operator añaden el estado de sincronización y la caducidad del lease de Vault para los Secrets que gestionan esos operadores. La extensión más antigua freelens-credential-explorer solo funciona en FreeLens 1.9 y versiones 1.x posteriores.

¿Las extensiones de FreeLens se instalan por clúster o por usuario?

Por usuario. Una extensión instalada está disponible en todos los clústeres de tu catálogo. Si a un clúster le faltan las CRDs de las que depende una extensión —Flux, Karpenter, KEDA, Velero—, sus vistas se quedan vacías en ese clúster en lugar de fallar.

¿Qué extensión de FreeLens es la más utilizada?

La extensión de FluxCD, con una diferencia clara: alrededor de 130 estrellas en GitHub, más del triple que la siguiente. Expone Kustomizations, HelmReleases, GitRepositories y su estado de reconciliación como vistas de primer nivel, que es la mayor carencia de FreeLens de serie para los equipos que trabajan con GitOps.

Para seguir leyendo