agy-select 🤖🔍

agy-select é uma interface de terminal interativa (TUI) moderna estilo lazygit, escrita em Python 3, para gerenciar, pesquisar e retomar rapidamente sessões de conversa passadas da CLI do Google Antigravity (agy). Compatível com Linux, macOS e Windows.

Read this in other languages: English.

---

Recursos (Features)

• 🖥️ Interface Estilo Lazygit: Layout com 4 painéis organizados ([1] Search, [2] Local Chats, [3] Global Chats e [4] Preview) com navegação fluida.
• 📂 Separação Local vs. Global: Detecta automaticamente conversas iniciadas no diretório do projeto atual vs. conversas de outros workspaces (totalmente adaptado para caminhos NTFS do Windows e Unix).
• ⚡ Desempenho Ultra-rápido: Leitura instantânea via metadados do SQLite do Antigravity e carregamento sob demanda (lazy-loading) do histórico completo.
• 🔍 Busca com Regex e Padrões (UTF-8): Suporte completo a expressões regulares (ex.: erro|falha, def\s+\w+) e caracteres acentuados, com fallback seguro para busca literal enquanto digita.
• ✨ Destaque Visual Diferenciado no Preview: Ocorrências encontradas pelo padrão de busca são destacadas em amarelo, e a ocorrência ativa atual fica em destaque especial magenta com negrito.
• 🎯 Navegação de Ocorrências (n / N): Pule diretamente para o próximo (n) ou anterior (N) match no preview rastreando visualmente a ocorrência ativa sem travar a rolagem manual livre.
• 👁️ Preview com Rolagem Completa: Visualização em balões estilizados com quebra de linha dinâmica (word-wrap), rolagem e estimativa de uso da janela de contexto.
• 🛡️ Limpeza Inteligente sem Perda de Código: Remove metadados internos do Antigravity (<USER_REQUEST>, <skills>, <identity>) mantendo código-fonte, templates C++, generics e tags intactos.
• 🏷️ Renomeação Persistente: Renomeie conversas selecionadas pressionando r, com diálogo interativo e persistência imediata no SQLite do Antigravity.
• 🗑️ Exclusão Segura: Apague conversas indesejadas diretamente pela interface (d), com diálogo de confirmação seguro que remove logs e bancos de dados da sessão.
• 🖱️ Suporte Completo a Mouse: Clique para focar e selecionar itens em qualquer painel, além de suporte a rolagem direcionada pelo ponteiro do mouse.
• 🪟 Suporte Cross-Platform (Linux, macOS, Windows): Funciona no Windows Terminal, PowerShell, CMD e terminais POSIX com UTF-8 e inicialização transparente de subprocesso.

---

Pré-requisitos

• python (v3.8 ou superior).
  • No Windows: requer a biblioteca windows-curses (o agy-select detecta e tenta auto-instalar na primeira execução, ou execute pip install windows-curses).
• agy (Google Antigravity CLI)

Não requer fzf, jq ou ferramentas externas adicionais.

---

Instalação e Configuração

🐧 Linux / 🍎 macOS

1. Clone este repositório:

   git clone https://github.com/Tefo02/agy-select.git
   cd agy-select

2. Copie o executável para o seu diretório de binários locais:

   mkdir -p ~/.local/bin
   cp agy-select ~/.local/bin/agy-select
   chmod +x ~/.local/bin/agy-select

3. Adicione um alias (opcional) no seu ~/.bashrc ou ~/.zshrc:

   echo "alias agy-select='~/.local/bin/agy-select'" >> ~/.bashrc
   source ~/.bashrc

🪟 Windows (PowerShell / CMD / Windows Terminal)

1. Clone este repositório:

   git clone https://github.com/Tefo02/agy-select.git
   cd agy-select

2. Instalação rápida automatizada (PowerShell):

   powershell -ExecutionPolicy Bypass -File .\install.ps1

   O script instala windows-curses se necessário e copia agy-select e agy-select.cmd diretamente para %LOCALAPPDATA%\agy\bin (que já está configurado no seu PATH).

3. Ou Instalação Manual:

   pip install windows-curses
   # Copie os arquivos para a pasta de binários do agy ou qualquer pasta no PATH:
   Copy-Item agy-select, agy-select.cmd -Destination "$env:LOCALAPPDATA\agy\bin"

---

Como Usar

Basta digitar agy-select no seu terminal:

agy-select

Atalhos de Teclado

Tecla / Atalho	Ação
ENTER	Retoma a conversa selecionada no agy (ou muda o foco se estiver na busca)
TAB / Shift+TAB	Alterna o foco sequencialmente entre os painéis (1 → 2 → 3 → 4)
1, 2, 3, 4	Foca diretamente o painel correspondente
n / N	Pula para a próxima / anterior ocorrência encontrada no preview
↑ / ↓ ou k / j	Navega pelos itens da lista ou rola o preview livremente
← / → ou h / l	Rola horizontalmente títulos longos na lista
Home / End	Pula para o primeiro / último item ou topo / fim do preview
PageUp / PageDown	Rola rapidamente o painel de preview
/	Pula imediatamente para a caixa de busca
Ctrl+U	Limpa o campo de busca
r	Renomeia o título da conversa selecionada (com diálogo e persistência no SQLite)
d	Exclui permanentemente a conversa selecionada (com confirmação)
q / ESC	Sai do aplicativo (ou desativa foco da busca)

---

English Version 🇬🇧

agy-select is a modern, interactive Lazygit-style Terminal User Interface (TUI) written in Python 3 to manage, search, and resume past Google Antigravity (agy) CLI sessions. Fully compatible with Linux, macOS, and Windows.

Features

• 🖥️ Lazygit-Style Interface: 4 dedicated panels ([1] Search, [2] Local Chats, [3] Global Chats, and [4] Preview) with smooth keyboard and mouse navigation.
• 📂 Local vs. Global Detection: Automatically separates chats associated with the current workspace from global conversations (cross-platform NTFS and Unix path resolution).
• ⚡ High Performance: Instant startup using Antigravity's SQLite metadata and on-demand lazy loading of full transcripts.
• 🔍 Full-text Search with Regex & UTF-8: Search by conversation ID, topic title, or dialogue content using regular expressions (e.g. error|fail, def\s+\w+) with safe literal fallback.
• ✨ Distinct Visual Highlights in Preview: Search pattern occurrences are highlighted in yellow, while the currently active/tracked match shines in high-contrast bold magenta.
• 🎯 Match Navigation (n / N): Jump sequentially between next (n) and previous (N) search matches, visually tracking the active occurrence without locking manual scrolling.
• 👁️ Full Transcript Preview: Styled message bubbles with dynamic word wrapping, scroll tracking, and context window estimation.
• 🛡️ Smart Code Preservation: Strips internal Antigravity tags without mutilating code snippets, generics, or HTML.
• 🏷️ Persistent Session Renaming: Rename conversations with r, featuring an interactive dialog and persistent storage in SQLite.
• 🗑️ Safe Session Deletion: Delete unwanted conversations with d, wiping both transcript logs and session SQLite database safely.
• 🖱️ Full Mouse Support: Click to focus panels and select conversations, plus targeted mouse wheel scrolling.
• 🪟 Cross-Platform Support: Works in Windows Terminal, PowerShell, CMD, and Unix terminals with UTF-8 encoding and clean process resumption.

Prerequisites

• python (v3.8+)
  • Windows: requires windows-curses (auto-installed on first launch if missing, or install via pip install windows-curses).
• agy (Google Antigravity CLI)

Installation

Linux / macOS

1. Copy agy-select to ~/.local/bin/ and make it executable:

   mkdir -p ~/.local/bin
   cp agy-select ~/.local/bin/
   chmod +x ~/.local/bin/agy-select

2. Add an alias to your shell config file (e.g., ~/.bashrc or ~/.zshrc):

   echo "alias agy-select='~/.local/bin/agy-select'" >> ~/.bashrc
   source ~/.bashrc

3. Run it:

   agy-select

Windows (PowerShell / CMD / Windows Terminal)

1. Automated 1-command installer (PowerShell):

   powershell -ExecutionPolicy Bypass -File .\install.ps1

2. Manual install:

   pip install windows-curses
   Copy-Item agy-select, agy-select.cmd -Destination "$env:LOCALAPPDATA\agy\bin"

3. Run it:

   agy-select

Keyboard Shortcuts

Key / Shortcut	Action
ENTER	Resume selected conversation in agy (or switch focus from search box)
TAB / Shift+TAB	Cycle panel focus sequentially (1 → 2 → 3 → 4)
1, 2, 3, 4	Jump directly to corresponding panel
n / N	Jump to next / previous match in preview
↑ / ↓ or k / j	Navigate list items or scroll preview freely
← / → or h / l	Horizontally scroll long titles
Home / End	Jump to first / last item or top / bottom of preview
PageUp / PageDown	Fast scroll preview panel
/	Focus search box immediately
Ctrl+U	Clear search query
r	Rename selected conversation (with dialog and SQLite persistence)
d	Delete selected conversation permanently (with confirmation)
q / ESC	Quit application (or unfocus search)