Repolode
Enviar
baoyudu

baoyudu/perch

Un selector de terminal para volver a tus proyectos recientes de Claude Code o Codex y, si quieres, iniciar el agente o reanudar la última sesión.

Ver en GitHub
Estrellas
89
Forks
0
Issues abiertos
0
Último commit
hace 2 meses

¿Qué es?

perch es una herramienta de terminal escrita en Go que te permite volver al proyecto en el que trabajaste más recientemente con Claude Code o Codex. Lee el historial de sesiones que ambos agentes guardan en el disco, así que no requiere configuración: en cuanto se instala, aparece en una lista con búsqueda difusa cada proyecto en el que hayas abierto un agente.

Desde el selector, una sola tecla permite cambiar de directorio, iniciar claude o codex, o reanudar la última conversación. Cada fila de proyecto muestra el agente usado más recientemente, el tiempo transcurrido, la rama de git y el número de archivos con cambios; además, un panel de vista previa muestra el final de la última conversación. Puedes fijar proyectos en la parte superior y definir valores predeterminados y argumentos adicionales para cada proyecto en un archivo de configuración TOML opcional.

Como un proceso hijo no puede cambiar el directorio de su shell padre, perch muestra su interfaz en la terminal e imprime la ruta y el comando elegidos para que los ejecute una pequeña función de shell de `perch init`. La configuración está disponible para zsh, bash y fish, y el modo de aplicación de escritorio de Codex envía los proyectos a la aplicación mediante un enlace codex://.

Funciones clave

  • 01Lee el historial de sesiones existente de Claude Code y Codex sin necesidad de configuración.
  • 02Filtra proyectos por nombre y ruta mediante búsqueda difusa.
  • 03Permite cambiar de directorio, iniciar claude o codex, o reanudar la última sesión con una sola tecla.
  • 04Muestra el agente usado más recientemente, la rama de git y el número de archivos con cambios de cada proyecto.
  • 05Muestra una vista previa del final de la última conversación.
  • 06Permite fijar proyectos y definir acciones y argumentos predeterminados para cada uno en TOML.

Casos de uso

  • Cambiar entre muchos repositorios en los que ejecutas agentes de programación.
  • Retomar la conversación del día anterior en Claude Code o Codex al abrir una terminal nueva.
  • Iniciar un agente en un proyecto específico con opciones personalizadas con una sola tecla.

Inicio rápido

  1. 1

    Instala perch con Homebrew (macOS)

    brew install --cask baoyudu/tap/perch
  2. 2

    O instálalo desde el código fuente con Go

    go install github.com/baoyudu/perch/cmd/perch@latest
  3. 3

    Añade la línea de integración del shell al archivo rc de tu shell (se muestra zsh)

    eval "$(perch init zsh)"
  4. 4

    Abre un terminal nuevo y escribe p para iniciar el selector

Antes de usarlo

  • Necesita el historial de sesiones de Claude Code y Codex almacenado en el disco para mostrar los proyectos.
  • Algunas funciones, como los iconos de Nerd Font, requieren una fuente de terminal parcheada, aunque también hay un modo sencillo.

En colecciones

Aplicaciones con interfaz de terminal (TUI)Herramientas, skills y plugins para Claude CodeAsistentes y agentes de programación con IAHerramientas de CLI y terminal

Temas

#terminal#tui#claude-code#codex#cli#developer-tools#golang#bubbletea

Preguntas frecuentes

¿Qué es perch?
Un selector de terminal para volver a tus proyectos recientes de Claude Code o Codex y, si quieres, iniciar el agente o reanudar la última sesión. perch es una herramienta de terminal escrita en Go que te permite volver al proyecto en el que trabajaste más recientemente con Claude Code o Codex. Lee el historial de sesiones que ambos agentes guardan en el disco, así que no requiere configuración: en cuanto se instala, aparece en una lista con búsqueda difusa cada proyecto en el que hayas abierto un agente.
¿perch es gratuito? ¿Qué licencia tiene?
perch es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿perch sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de perch fue el 14 sept 2026.
¿Para qué puedo usar perch?
Cambiar entre muchos repositorios en los que ejecutas agentes de programación. Retomar la conversación del día anterior en Claude Code o Codex al abrir una terminal nueva. Iniciar un agente en un proyecto específico con opciones personalizadas con una sola tecla.
¿Cómo se instala perch?
Instala perch con Homebrew (macOS): brew install --cask baoyudu/tap/perch O instálalo desde el código fuente con Go: go install github.com/baoyudu/perch/cmd/perch@latest Añade la línea de integración del shell al archivo rc de tu shell (se muestra zsh): eval "$(perch init zsh)" Abre un terminal nuevo y escribe p para iniciar el selector
¿Dónde consigo perch?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/baoyudu/perch

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados