Índice da documentação

// Documentação do Singularity

Os terminais

O Singularity integra verdadeiros terminais do sistema no workbench. Abre vários shells, encontra as sessões dos teus agentes e trabalha no diretório certo sem sair do contexto do teu espaço de trabalho.

Abrir um terminal

Clica em New terminal na barra de separadores do Deck, ou abre a vista Terminals do navegador e cria uma sessão. O Aperture também permite ir para a vista Terminal: abre-o com ⌘K no macOS ou Ctrl K no Windows e Linux e procura terminal.

A partir da árvore de um projeto, a ação Open in Terminal inicia o shell no projeto selecionado ou na pasta que contém o ficheiro. Um terminal criado sem contexto de ficheiro usa a pasta do espaço de trabalho quando existe e, caso contrário, o primeiro projeto desse espaço.

Terminal nativo aberto num separador do Deck do Singularity
Cada novo terminal torna-se um separador independente no Deck.

Um terminal a sério

O terminal não é uma consola que imita alguns comandos. O Singularity usa o xterm.js para a apresentação e o node-pty para abrir um PTY nativo. Trabalhas, portanto, com o shell do teu sistema, o seu ambiente, aliases, funções e as ferramentas interativas instaladas no teu computador.

As cores ANSI, o redimensionamento e os programas em ecrã inteiro passam pelo mesmo tipo de sessão PTY que numa aplicação de terminal dedicada.

Gerir as sessões

O botão New terminal cria sempre um novo shell: várias sessões podem, assim, executar comandos em paralelo. Cada sessão tem o seu próprio separador terminal: e o seu próprio processo. Fecha o separador para fechar um shell de utilizador; a vista Terminals do navegador agrupa as sessões do espaço ativo e permite reabri-las ou terminá-las.

Os terminais estão associados ao seu espaço de trabalho. Mudar de espaço oculta as sessões dos outros espaços sem as parar; voltam a aparecer quando regressas ao respetivo espaço.

Os terminais de agentes

Cada execução de agente tem o seu próprio terminal. Durante a missão, mostra a saída real do fornecedor; depois de terminar, o histórico continua disponível só de leitura e um campo próprio pode permitir retomar a conversa. Uma sessão retransmitida a partir de outra máquina também é só de leitura.

Fechar a vista de um agente não mata o seu processo. Encontra-a em Terminals ou a partir do ticket, e usa explicitamente a ação de paragem se quiseres interromper a execução. Consulta a orquestração de agentes de IA para o ciclo completo.

Definições do terminal

Abre Settings → Terminal. Na versão 2.17, este painel contém exatamente duas opções de limpeza:

  • Auto-close done-ticket terminals: fecha automaticamente o terminal de um agente quando o seu ticket está concluído e a sessão não voltou a ser utilizada.
  • Inactivity Timeout: número de minutos antes desse fecho, de 1 a 1 440.

O tipo de letra, o seu tamanho e a profundidade do histórico de deslocamento não são configuráveis neste painel. O Singularity usa atualmente Geist Mono a 12 px (reduzido para 11 px num painel estreito) e mantém cerca de 30 000 linhas.

Painel de definições Terminal com as opções de fecho automático
O painel Terminal configura apenas a limpeza das sessões de agentes concluídas.

Atalhos úteis

  • Copiar: ⌘C no macOS, ou Ctrl C com uma seleção e Ctrl Shift C no Windows e Linux.
  • Colar: ⌘V no macOS, Ctrl Shift V no Windows e Linux.
  • Pesquisar no histórico: ⌘F ou Ctrl F. Enter passa ao resultado seguinte, Shift Enter ao anterior e Escape fecha a pesquisa.
  • Limpar o ecrã: usa o comando habitual do teu shell, por exemplo clear, ou o seu atalho quando existir. O Singularity não acrescenta um atalho de limpeza próprio.

Perguntas frequentes

O terminal do Singularity é um shell simulado?

Não. O xterm.js apresenta a sessão, enquanto o node-pty lança um PTY nativo ligado ao shell do teu sistema.

Fechar o separador de um agente para a sua execução?

Não. Fechar a sua vista desanexa o terminal; a execução continua e pode ser encontrada a partir da vista Terminals. Usa a ação de paragem para terminar realmente o agente.