Uso diário
Execute tarefas focadas, oriente trabalhos em andamento, inspecione resultados e mantenha as sessões organizadas sem perder o controle do workspace.
Comece no workspace correto
O Clarvis considera o diretório atual como o workspace:
cd caminho/para/seu-projeto
clarvisAntes de solicitar alterações, confira os indicadores de workspace e segurança no cabeçalho. Se o repositório fornecer configuração executável, revise-a com /workspace-trust.
Escreva uma tarefa útil
Uma boa solicitação informa o resultado esperado, os limites importantes e as evidências que você espera receber:
Corrija a regressão do estado vazio no seletor de contas. Preserve o estilo visual atual, adicione
um teste de regressão, execute as verificações focadas e resuma os arquivos alterados.Use @ para mencionar um arquivo do workspace. Imagens selecionadas por uma menção são anexadas ao turno. Digite / para pesquisar comandos e destinos.
Dica
Comece trabalhos desconhecidos com uma solicitação limitada e somente leitura. Quando as evidências estiverem claras, peça a alteração na mesma sessão.
Oriente ou cancele o trabalho ativo
Enviar texto durante uma execução ativa orienta essa execução, sem criar outra execução concorrente:
Mantenha a API pública inalterada e concentre a correção no adaptador.Pressione Ctrl+C para cancelar o trabalho ativo. Escape limpa um rascunho ou fecha a tela atual, mas não cancela uma execução. O Clarvis mostra no rodapé as ações disponíveis na tela atual.
Inspecione o resultado
/diffabre o diff em foco ou o mais recente./planspermite navegar pelo histórico de planos mantidos.- Ctrl+P abre o plano atual ou o mais recente.
/workflowabre o histórico de execuções de workflows e a árvore entre gerenciador e agentes./statusmostra o agente, o modelo, o uso de tokens e o estado da execução atual./exportgrava a transcrição persistida completa em um arquivo Markdown.
Compare as afirmações com os resultados de ferramentas e os diffs exibidos antes de aceitar um trabalho relevante.
Mantenha as sessões intencionais
Uma sessão é a conversa contínua de um workspace. Uma execução é uma unidade de trabalho do agente dentro dessa sessão.
/cleararquiva a sessão atual e inicia outra./sessionsretoma, exporta ou exclui sessões salvas.clarvis --continueretoma a sessão usada mais recentemente no workspace atual.clarvis --listlista as sessões salvas.clarvis --resume <session-id>retoma uma sessão específica.
Use /compact quando uma sessão longa precisar preservar seu contexto importante em um resumo menor. Adicione uma instrução opcional quando algo específico precisar sobreviver:
/compact Preserve a decisão de API aceita e todos os bloqueios de lançamento ainda não resolvidos.Execute uma tarefa delimitada sem interface
Para scripts ou uma saída avulsa, use o modo de impressão:
clarvis --agent explorer --format md -p "Mapeie o fluxo de autenticação. Não edite arquivos."O modo sem interface não consegue responder a solicitações interativas de aprovação. O Clarvis as nega em vez de esperar indefinidamente. Use a TUI interativa em trabalhos que possam exigir aprovação de comandos, planos ou workflows.
Atenção
Uma entrada iniciada por ! executa um comando shell local diretamente no workspace. É um comando seu, não uma chamada de ferramenta do agente, e não passa pelo sandbox nem pela política de revisão de comandos do agente.