Repolode
Enviar
baoyudu

baoyudu/perch

Um seletor de terminal para voltar rapidamente aos projetos recentes do Claude Code ou Codex, relançar o agente ou retomar a última sessão.

Ver no GitHub
Estrelas
89
Forks
0
Issues abertas
0
Último commit
há 2 meses

O que é?

perch é uma ferramenta de terminal feita em Go para voltar ao projeto em que você estava trabalhando com Claude Code ou Codex. Ela lê o histórico de sessões que os dois agentes já mantêm no disco, então não exige configuração: assim que a ferramenta é instalada, todos os projetos em que você abriu um agente aparecem em uma lista com busca fuzzy.

No seletor, um único pressionamento de tecla permite apenas trocar de diretório, iniciar claude ou codex ou retomar a última conversa. Cada linha de projeto mostra o agente usado por último, o tempo relativo, a branch do git e a quantidade de arquivos modificados; um painel de prévia mostra o trecho final da última conversa. É possível fixar projetos no topo e definir ações padrão e argumentos extras para cada projeto em um arquivo TOML opcional.

Como um processo filho não pode mudar o diretório do shell pai, perch exibe a interface no terminal e imprime o caminho e o comando escolhidos para que uma pequena função de shell criada por `perch init` os execute. Há configuração para zsh, bash e fish, e um modo para o app desktop do Codex encaminha os projetos para o aplicativo por meio de um link codex://.

Recursos principais

  • 01Lê o histórico de sessões existente do Claude Code e do Codex sem exigir configuração.
  • 02Filtra projetos por nome e caminho usando busca fuzzy.
  • 03Permite trocar de diretório, iniciar claude ou codex ou retomar a última sessão com um único pressionamento de tecla.
  • 04Mostra o agente usado por último, a branch do git e a quantidade de arquivos modificados de cada projeto.
  • 05Mostra uma prévia do trecho final da última conversa.
  • 06Permite fixar projetos e definir ações padrão e argumentos para cada projeto em TOML.

Casos de uso

  • Alternar entre vários repositórios em que você usa agentes de programação.
  • Retomar a conversa de ontem no Claude Code ou Codex depois de abrir um novo terminal.
  • Iniciar um agente em um projeto específico com flags personalizadas usando um único pressionamento de tecla.

Início rápido

  1. 1

    Instale o perch com Homebrew (macOS)

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

    Ou instale a partir do código-fonte com Go

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

    Adicione a linha de integração do shell ao arquivo rc do seu shell (exemplo com zsh)

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

    Abra um novo terminal e digite p para iniciar o seletor

Antes de usar

  • Depende do histórico de sessões do Claude Code e do Codex armazenado no disco para listar os projetos.
  • Alguns recursos, como os ícones do Nerd Font, precisam de uma fonte de terminal com patches, mas também há um modo simples.

Em coleções

Aplicativos com interface de terminal (TUI)Ferramentas, skills e plugins para Claude CodeAssistentes e agentes de programação com IAFerramentas de CLI e terminal

Tópicos

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

Perguntas frequentes

O que é perch?
Um seletor de terminal para voltar rapidamente aos projetos recentes do Claude Code ou Codex, relançar o agente ou retomar a última sessão. perch é uma ferramenta de terminal feita em Go para voltar ao projeto em que você estava trabalhando com Claude Code ou Codex. Ela lê o histórico de sessões que os dois agentes já mantêm no disco, então não exige configuração: assim que a ferramenta é instalada, todos os projetos em que você abriu um agente aparecem em uma lista com busca fuzzy.
perch é gratuito? Qual é a licença?
perch é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
perch ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de perch foi em 14 de set. de 2026.
Para que posso usar perch?
Alternar entre vários repositórios em que você usa agentes de programação. Retomar a conversa de ontem no Claude Code ou Codex depois de abrir um novo terminal. Iniciar um agente em um projeto específico com flags personalizadas usando um único pressionamento de tecla.
Como instalar perch?
Instale o perch com Homebrew (macOS): brew install --cask baoyudu/tap/perch Ou instale a partir do código-fonte com Go: go install github.com/baoyudu/perch/cmd/perch@latest Adicione a linha de integração do shell ao arquivo rc do seu shell (exemplo com zsh): eval "$(perch init zsh)" Abra um novo terminal e digite p para iniciar o seletor
Onde consigo perch?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/baoyudu/perch

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados