Maccy + iTerm2 / Warp: un flujo de trabajo con el portapapeles que sobrevive a la terminal

Ejecutaste kubectl get pods -n staging hace cuarenta minutos. Desde entonces has ajustado los flags dos veces. Ahora necesitas la segunda versión, pero has copiado otras tres cosas entremedias. El historial del shell guarda el comando, pero no la salida que copiaste, ni el stack trace que sacaste del navegador, ni la ruta que arrastraste desde Finder.

Ese hueco entre el historial del shell y el historial del portapapeles es donde un gestor de portapapeles se gana el sitio. Esta guía explica cómo configurar Maccy Clipboard junto a iTerm2 o Warp, qué ajustes importan, dónde se solapan ambas herramientas y dónde se comportan distinto.

¿Funciona Maccy con iTerm2 y Warp?

Sí. Maccy es un gestor de portapapeles de la barra de menús que consulta el pasteboard de macOS, así que captura cualquier app que copie al portapapeles del sistema, terminales incluidas. No hay ninguna integración específica que instalar. Lo mismo ocurre con pbcopy: lo que le pases por una tubería aparece en el historial de Maccy como cualquier otra copia.

Escenario	¿Lo captura Maccy?	Notas
Seleccionar texto en iTerm2 y Cmd+C	Sí	Escritura estándar en el pasteboard.
iTerm2 «Copy to pasteboard on selection»	Sí, pero con mucho ruido	Cada selección se convierte en una entrada del historial. Mira los consejos más abajo.
echo "texto" | pbcopy	Sí	Útil para scripts y alias.
Copiar la salida de un bloque en Warp	Sí	Warp escribe en el pasteboard del sistema.
Portapapeles remoto de tmux/SSH mediante OSC 52	Depende	Solo si la terminal tiene permitido aceptar escrituras de portapapeles por OSC 52. Más abajo.
Texto seleccionado dentro de tmux con el modo ratón activado	Depende	tmux puede conservar la selección en su propio búfer, salvo que lo configures para pasarla al portapapeles del sistema.

Configuración: la versión de cinco minutos

1. Instala. Descárgalo desde el repositorio de GitHub o ejecuta brew install maccy.
2. Concede permisos. Si quieres que Maccy pegue por ti en la app en primer plano, macOS exige acceso de Accesibilidad (Ajustes del Sistema → Privacidad y seguridad → Accesibilidad). Sin él, Maccy copia el elemento y tú lo pegas a mano con Cmd+V.
3. Cambia el modo de búsqueda a Regex. En los ajustes de Maccy, pestaña General, cambia el modo de búsqueda de difusa (fuzzy) a expresiones regulares . Los fragmentos de terminal están muy estructurados, así que las regex se amortizan al instante.
4. Revisa la pestaña Ignore. Añade tu gestor de contraseñas y cualquier otra app que maneje secretos.
5. Resuelve el conflicto de atajos (siguiente sección).

El conflicto de atajos del que nadie te avisa

El atajo global por defecto de Maccy es Shift+Cmd+C. En iTerm2, esa misma combinación activa el Modo Copia (Copy Mode), la función de selección de texto con el teclado. Los atajos globales se registran a nivel de sistema, así que en la práctica Maccy suele ganar y el Modo Copia deja de responder . Warp también asigna atajos con combinaciones de Cmd+Shift, así que revisa Settings → Keyboard shortcuts antes de dar por hecho que no hay solapamientos.

Tienes dos opciones:

• Cambiar el atajo de Maccy (normalmente la solución más sencilla). Mucha gente lo mueve a algo como Cmd+Shift+V o a una combinación con Option que ninguna terminal use. Abre los ajustes de Maccy y graba un atajo nuevo.
• Reasignar el Modo Copia de iTerm2 en Settings → Keys → Key Bindings, si de verdad lo usas a diario.

Elige una y pruébala con la terminal en primer plano. Un atajo que funciona en Finder puede comportarse distinto en una app que captura las teclas de forma agresiva.

Un flujo de trabajo, no una lista de funciones

1. Reconstruir un comando a partir de tres fuentes

Imagina que copias el nombre de un pod desde un dashboard, un namespace desde Slack y un flag desde la documentación. Abre Maccy, elige cada uno en orden y pégalos en tu prompt. Como Maccy lista los elementos del más reciente al más antiguo y los numera, retroceder tres o cuatro entradas son una o dos pulsaciones en lugar de un viaje de vuelta a cada app de origen.

2. Buscar fragmentos con regex

Con el modo regex activado puedes acotar el historial con precisión. Algunos ejemplos:

Qué quieres	Prueba
Cualquier comando git copiado	^git
Cualquier cosa que parezca una ruta absoluta	^/[\w./-]+
Direcciones IPv4	\b\d{1,3}(\.\d{1,3}){3}\b
Líneas de stack trace	Exception|Traceback|at .+\(.+:\d+\)
Referencias a imágenes de Docker	[\w.-]+/[\w.-]+:[\w.-]+

3. Fijar lo que sueles reescribir

Maccy permite fijar elementos para que se queden arriba y sobrevivan a la limpieza del historial. Buenos candidatos para el trabajo en terminal: la cadena de tu jump host SSH, un docker run largo con montaje de volúmenes, la URL base de la API de staging o una invocación de rsync con muchos flags. Los elementos fijados son una alternativa ligera a los alias del shell cuando el fragmento cambia a menudo o incluye valores que prefieres no commitear en tus dotfiles. En las versiones recientes, el atajo para fijar es Option+P .

4. Pegar sin arrastrar texto enriquecido

El texto copiado de una página web puede llevar formato. Las terminales ignoran casi todo, pero el editor de entrada de Warp y algunas herramientas TUI pueden comportarse de forma rara con caracteres inesperados, como las comillas tipográficas, que rompen comandos del shell sin avisar. Maccy tiene una acción de pegar sin formato (Option+Shift+Return ) que elimina el formato y deja texto plano. Si un comando copiado de un blog «parece correcto» pero falla, lo más probable es que sean las comillas curvas.

iTerm2 vs Warp: qué cambia para el uso del portapapeles

	iTerm2	Warp
Historial de portapapeles integrado	Sí. Ventana Paste History, con guardado opcional en disco	No hay un equivalente completo a nivel de sistema, pero su editor de entrada y su historial de comandos cubren parte de las necesidades
Copiar al seleccionar	Ajuste opcional; inunda Maccy si está activado	Ajuste opcional
Seguridad al pegar varias líneas	Avisos configurables; Advanced Paste para retocar el texto antes de enviarlo	El editor de entrada permite revisar y editar texto multilínea antes de ejecutarlo
OSC 52 (portapapeles remoto)	Compatible; hay que activarlo en los ajustes	Consulta la documentación actual
Mejor combinación con Maccy	Historial entre apps; el historial de pegado de iTerm2 se queda solo en la terminal	El editor de Warp facilita inspeccionar antes los fragmentos multilínea que pegas

Una nota honesta: el Paste History integrado de iTerm2 se solapa con Maccy si solo copias dentro de la terminal. Si vives por completo dentro de iTerm2, quizá no necesites otra herramienta. Maccy gana cuando tus fragmentos vienen de todas partes (navegador, Slack, Finder, Xcode) y quieres un único atajo coherente.

Seguridad: que tu historial no se convierta en un registro de secretos

El trabajo en terminal deja cadenas sensibles en el portapapeles: tokens de API, valores de .env, claves SSH, URLs de bases de datos. Maccy guarda el historial en local, sin sincronización en la nube, lo cual es una ventaja real de privacidad. Pero «local» sigue significando «en disco», así que conviene ser deliberado.

• Ignora tu gestor de contraseñas. Añádelo en los ajustes de Ignore de Maccy. Muchos gestores de contraseñas además marcan sus escrituras en el portapapeles como ocultas siguiendo la convención comunitaria de nspasteboard.org, que los gestores de portapapeles pueden respetar .
• Usa la exclusión por regex de Maccy para patrones de tokens. Si la pestaña Ignore permite ignorar por patrón , añade algo como ^(ghp_|sk-|AKIA)[A-Za-z0-9]+ para no almacenar los formatos de token más comunes.
• Borra el historial tras sesiones sensibles. Maccy tiene una acción para borrar el historial (en el menú y con atajo de teclado) precisamente para esto.
• No ignores la terminal entera. Eso iría contra el propósito. Sé selectivo.

Problemas habituales y soluciones

Problema	Causa probable	Solución
El historial se llena de fragmentos	«Copiar al seleccionar» está activado	Desactívalo en los ajustes de la terminal, o acepta el ruido y apóyate en la búsqueda
Maccy se abre pero no pega automáticamente	Falta el permiso de Accesibilidad	Concédelo en Ajustes del Sistema → Privacidad y seguridad
El Modo Copia de iTerm2 dejó de funcionar	Conflicto de atajos	Reasigna el atajo de Maccy
El comando pegado falla con caracteres extraños	Comillas tipográficas o formato oculto de la fuente	Pega sin formato
La copia remota de tmux nunca llega a Maccy	tmux o SSH no reenvían al portapapeles del sistema	Activa OSC 52 en tmux y en la terminal
Un pegado grande bloquea el shell	No es Maccy: el cuello de botella es la terminal o el shell	Usa la opción de pegado lento de iTerm2 o guarda el contenido en un archivo y haz source

Dónde Maccy no es la herramienta adecuada

Maccy guarda lo que copias. No entiende comandos, no ejecuta snippets con variables y no sincroniza entre equipos. Si necesitas plantillas de comandos parametrizadas, un gestor de snippets o las funciones del shell lo hacen mejor. Si necesitas tu portapapeles en dos Macs, el diseño local-first de Maccy es una decisión deliberada, no un fallo. Y para recuperar comandos en concreto, la búsqueda inversa con Ctrl+R (o una herramienta como fzf o atuin) supera a cualquier gestor de portapapeles. Se complementan: el historial del shell recuerda lo que ejecutaste; Maccy recuerda lo que copiaste.

La versión corta

Instala Maccy, mueve su atajo fuera de Shift+Cmd+C, cambia a búsqueda con regex, ignora tu gestor de contraseñas y fija los pocos snippets que sueles reescribir. Son unos cinco minutos de configuración para tener un portapapeles en el que de verdad se puede buscar. ¿Cuál sería el primero que fijarías: la cadena del jump host o ese docker run que has escrito cincuenta veces?