Manual do usuário do VelaTerm
Este é o manual do usuário do VelaTerm. Se você está começando, leia os quatro primeiros capítulos na ordem e consulte os demais conforme a necessidade.
Ordem de leitura
| # | Capítulo | Conteúdo | Para quem |
|---|---|---|---|
| 1 | Introdução | Instalação, adição de um projeto, o primeiro terminal e a primeira sessão de agente, um tour pela janela | Todos os novos usuários; comece por aqui |
| 2 | Gerenciamento de Interface e Sessões | Layout da janela, a árvore de projetos e seus menus, coleções, marcas, abas e abas em segundo plano, painéis divididos e disposição lado a lado, filtros de status, arquivamento, busca global, salvamento do espaço de trabalho | Todos os usuários |
| 3 | Sessões do Agente de IA | Os quatorze agentes compatíveis e seus recursos, pontos de status e notificações, retomada, importação e bifurcação de conversas, permissões, predefinições, orientações de instalação, o painel Informações | Quem usa agentes de programação com IA |
| 4 | Visão de Conversa | Alternância entre a visão de terminal e a visão de conversa, envio de mensagens enquanto o agente trabalha (fila, instrução adicional, interrupção), controles de modelo, esforço e permissões, imagens, comandos, reversão, tarefas em segundo plano, continuação automática após limites de uso, entrada na conta | Usuários de Claude Code, Codex, OpenCode, Pi e OMP |
| 5 | Criação de Sessões e Colaboração no Git | Início de sessões filhas com vspawn, o cartão de confirmação, worktrees, o menu Git e o merge gráfico | Trabalho em paralelo com vários agentes |
| 6 | Planejamento e Execução | Fluxos com sessões de planejamento e de execução, divisão do trabalho em várias tarefas revisadas, modos de diretório, acompanhamento do progresso | Tarefas maiores que exigem planejamento e revisão |
| 7 | Comandos de Sessão | Referência dos dez comandos integrados (vspawn, vspawn-tree, vopen, vrefer, vsearch, vstat, vtell, vrun, vkb, vflow), das Vela Skills, incluindo vask, e do comando de shell vela | Referência para usuários e scripts |
| 8 | Uso do Terminal | Noções básicas do terminal, busca no terminal, copiar e colar, colagem de imagens, sugestões de comandos, os comandos integrados e os comandos vrun em segundo plano, escolha do shell no Windows, gravação de sessões, opções de renderizador, atalhos comuns | Todos os usuários |
| 9 | Sugestões de Comandos | Sugestões baseadas nos preenchimentos do próprio shell em terminais comuns: configurações e controles, shells compatíveis, como a integração é carregada, a situação atual no Windows, limitações | Quem usa o terminal no macOS e no Linux |
| 10 | Abas de Documento e Navegador | Abas de documento (abertura de arquivos, o editor Markdown, edição e salvamento, novos documentos e exportação para PDF), abas de navegador no aplicativo desktop e a convivência entre os tipos de aba | Conforme a necessidade |
| 11 | Bases de Conhecimento Locais | Pastas Markdown como bases de conhecimento: abertura ou criação de uma base, importação de arquivos e pastas, escrita e organização de notas, busca, links, cópia a partir da base de conhecimento de sessões, armazenamento | Anotações e documentação |
| 12 | Base de Conhecimento de Sessões | Organização do conhecimento extraído das sessões, histórico de organização, navegação e manutenção das entradas, sessões arquivadas, vínculos com o grafo de código | Registro de decisões e lições do trabalho com agentes |
| 13 | Grafo de Código e Base de Conhecimento | Indexação do código de um projeto, visualização dos símbolos e das relações entre eles, vínculo e revisão de entradas de conhecimento, consultas a partir de uma sessão, local de armazenamento dos dados (experimental) | Exploração de código |
| 14 | Auditorias de Código | Auditorias de segurança de um projeto com Codex ou Claude Code: modelos e esforço de raciocínio, integração com o Codex Security, escopo, relatórios, exportações (experimental) | Revisões de segurança |
| 15 | Configurações e Atalhos | Todos os itens das oito categorias de configurações, atalhos de teclado padrão e sua alteração, o seletor de nova sessão de agente | Referência |
| 16 | Desenvolvimento e Gerenciamento Remoto | Acesso remoto para outros dispositivos, conexão com outras máquinas por SSH (incluindo hosts Windows e o espelhamento do aplicativo desktop remoto), por URL ou pela sua conta, compartilhamento por meio de uma conta VelaTerm (experimental), transferência de arquivos, uso do VelaTerm no celular, desconexão e o que é preservado, segurança | Uso remoto e em dispositivos móveis |
Quer saber o que mudou em cada versão? Consulte o Registro de alterações.
Quatro ideias para conhecer primeiro
- Cada sessão de agente na árvore é uma conversa contínua. Se você fechar a sessão e abri-la de novo, a conversa continua. Para começar uma conversa nova, crie uma nova sessão.
- As abas funcionam como em um navegador. Por padrão, abrir uma sessão de agente reutiliza a aba atual, e a aba que você deixa continua em execução em segundo plano. Fechar uma aba encerra os processos dela; mesmo assim, a conversa com o agente pode ser retomada.
- Uma conversa, duas visões. Claude Code, Codex, OpenCode, Pi e OMP podem ser executados na visão de conversa ou na própria interface de terminal. Ao trocar de visão, a mesma conversa continua.
- Arquivar não é excluir. Arquive o trabalho concluído para manter a árvore organizada. As sessões arquivadas continuam legíveis na base de conhecimento e podem ser restauradas ou exportadas a qualquer momento.
Sobre as capturas de tela
As capturas de tela foram feitas em um ambiente de desenvolvimento com dados de demonstração, com a interface em inglês (o padrão do produto) e o tema escuro. Algumas capturas são anteriores a mudanças recentes na interface, como a aba Base de conhecimento no painel direito, o botão Feedback e a categoria de configurações Visualização da conversa; quando uma captura e o texto divergirem, vale o texto, que descreve a versão atual. Os números de uso da conta, os caminhos e detalhes semelhantes são valores de exemplo.