Usar o Desktop

O Imaginne Desktop é o aplicativo nativo (macOS e Windows) onde o agente roda localmente na sua máquina, com acesso aos seus arquivos. Esta página cobre o uso do dia a dia. Para instalar, veja Instalar Desktop; para os conceitos por trás (sessões, memória, autonomia), siga os links ao longo do texto.

O layout

A janela tem três regiões:

• Barra lateral (esquerda) — a lista de Projetos com o botão +; a navegação do workspace (Preview/Diff/Plan, Project Memory, Saved Prompts, Integrations, Run Details e a paleta de comandos ⌘/Ctrl+K); e o painel Files.
• Centro — o cabeçalho da sessão, a transcrição da conversa, o dock de permissão (quando o agente pede confirmação) e o campo de mensagem (composer). As mensagens do agente aparecem como Imaginne √-1.
• Dock direito — Preview, Diff e Plan. Overlays de tela cheia abrem por cima quando necessário.

Projetos e sessões

Um projeto é uma pasta de trabalho no seu computador.

• Criar — clique em + na barra lateral. O projeto é criado e uma sessão inicia automaticamente.
• Trocar — clique em outro projeto para mudar o workspace ativo.
• Excluir — remove o projeto do catálogo do app, mas não apaga a pasta do disco.

Cada projeto pode ter várias sessões. Use o menu de sessão (no cabeçalho) para criar, renomear ou arquivar. Você não troca de sessão enquanto o agente está respondendo — cancele ou aguarde. Veja Sessões.

Chat e comandos de barra

Escreva no composer e envie. Quando a mensagem começa com /, um menu suspenso de comandos aparece.

Ação	Tecla
Enviar	Enter
Quebrar linha	Shift+Enter
Cancelar o streaming	Esc

Comandos disponíveis:

Comando	O que faz
/login · /logout · /whoami	Entrar, sair e ver sua identidade (sem expor o token).
/model	Abre o seletor de modelo.
/memory	Abre a Project Memory.
/clear	Limpa a conversa atual.
/canvas	Abre/cria um quadro branco (whiteboard).
/image	Gera uma imagem a partir de um prompt.
/publish-skill	Publica uma skill local na sua organização.
/fb	Envia feedback para a equipe.
/help	Lista os comandos.

Comandos de modo (perfil Developer)

Se o seu Role for Developer (Configurações → Info), você também tem /plan, /exe e /ask para alternar o modo de trabalho do agente. Em contas Non-Developer esses comandos não aparecem.

Mencionar arquivos: @ e "+ Context"

Para apontar um arquivo do projeto, digite @ seguido do caminho — isso insere uma referência literal ao arquivo na mensagem.

Para incluir o conteúdo do arquivo no contexto do agente, use o botão + Context (limite de cerca de 100 KB por arquivo). É a diferença entre dizer "olhe este arquivo" e "aqui está o que tem dentro dele".

dica

Diferente da TUI, o composer do Desktop não tem autocomplete de @. Digite o caminho ou use + Context para anexar o conteúdo. Veja Arquivos & artefatos.

Modelo

O modelo padrão é nnumbers. Abra /model (ou o seletor no cabeçalho) para escolher outro — a lista é filtrada pela política da sua organização. Em uma organização de modelo único, a opção efetiva é apenas nnumbers. Veja Modelos.

Autonomia

A autonomia define quanto o agente pergunta antes de agir. Ajuste em Configurações → Info → Autonomia:

• Baixa — confirma toda ação com efeito.
• Média (padrão) — aprova o trivial e pede confirmação no sensível.
• Alta — age sem perguntar (mostra um aviso ao ativar).

O cofre (firewall de workspace) e as negações fixas continuam valendo em qualquer nível. Veja Autonomia & permissões.

Preview, Diff e Plan

O dock direito tem três abas, alternáveis por Alt+1/2/3:

• Preview — abre o arquivo selecionado renderizado (PDF, DOCX, XLSX, Mermaid). Botões abrir com o SO, @ Insert (insere uma referência no composer) e + Context (injeta o conteúdo).
• Diff — mostra as edições que o agente fez nos arquivos.
• Plan — exibe o plano do agente (somente leitura nesta versão; os botões Aprovar/Editar/Rejeitar ainda são placeholders desabilitados).

A navegação do workspace também tem Alt+4/5/6/7 para Memory / Saved Prompts / Integrations / Run Details.

Arquivos

O painel Files mostra a árvore do projeto. Você pode:

• Novo arquivo (Text, Markdown, Word, Excel ou PowerPoint), Nova pasta, excluir (✕) e mover (arrastar e soltar);
• abrir com o app do SO;
• alternar mostrar ocultos.

Além do workspace, o agente pode ler (somente leitura) de Documents, Downloads e Desktop, e de iCloud/OneDrive. A escrita sempre vai para o workspace.

Os arquivos gerados ficam organizados automaticamente por tipo no projeto — imagens (/image), canvases e as saídas das skills.

Voz

Há um botão de microfone no composer (oculto quando a voz não está disponível). Clique para iniciar e clique de novo para parar. A transcrição parcial aparece no campo de mensagem conforme você fala — e não é enviada sozinha: você revisa e envia. A voz é fala→texto e requer microfone e credenciais habilitadas pela sua organização. Veja Voz.

Saved Prompts e Rotinas

São dois recursos parecidos, com propósitos diferentes:

• Saved Prompts — prompts reutilizáveis por projeto, executados somente sob demanda (Run Now). Não têm agendamento, por design.
• Rotinas (Routines) — tarefas recorrentes globais do usuário, com um agendador real que dispara enquanto o app está aberto. Crie pela gaveta Routines → + New routine (campos de título, prompt, agendamento, modo de execução, notificações e mais).

Para a configuração completa de rotinas e a distinção entre os dois, veja Rotinas.

Canvas

O canvas é um quadro branco para organizar ideias visualmente:

• /canvas <título> cria um quadro;
• /canvas list lista os quadros existentes;
• duplo clique adiciona cartões;
• ⌘/Ctrl+Z desfaz.

Os quadros ficam salvos no projeto.

Apresentações

Não há comando a decorar: descreva a apresentação e o agente monta o deck com a skill nativa ppt_skill.

Crie uma apresentação executiva sobre o plano de marketing do 2º semestre, com 8 slides.

O motor nativo escolhe o visual automaticamente e gera o .pptx (mais PDF e miniaturas quando o visualizador está disponível) como artefato — você não escolhe template. Para a receita completa, veja Gerar uma apresentação.

Imagens: /image

O Desktop gera imagens a partir de prompts — descreva a imagem e o agente a cria:

/image um robô amigável apresentando um gráfico, estilo flat

O resultado aparece entre os artefatos do projeto. Pressione Esc para cancelar a geração.

Skills

As skills são capacidades que o agente usa quando relevantes (criar .pptx, .docx, .xlsx, PDF etc.).

• As skills inclusas (docx, excel, pdf, ppt_skill) são instaladas automaticamente.
• As skills da sua organização são sincronizadas ao iniciar o app.
• Todas aparecem no menu suspenso de /.

Em Configurações → Skills você vê as inclusas. No Desktop, instalar/desinstalar remotamente está desativado — essas skills são embutidas. Veja Skills e a seção Skills.

Publicar uma skill

Use /publish-skill (ou o modal correspondente):

1. Escolha uma skill local.
2. Pré-visualize o manifesto sintetizado.
3. Selecione um grupo (obrigatório).
4. Clique em Publicar.

Depois, use Open in /app para gerenciá-la no console. Veja Publicar skills.

Project Memory

A Project Memory mantém quatro notas persistentes — projeto, usuário, glossário e decisões — que o agente consulta entre sessões. Você também pode usar "Pin selected text" para fixar trechos relevantes na sessão atual. Veja Memória.

Sessão remota

Conduza a sua sessão local a partir de outra tela. Na pílula Remote, clique em Create pair para gerar um código (formato Crockford) com contagem de 30s e uma URL para compartilhar (<host>/remote). Botões Copy code/URL e Revoke. Há um par ativo por vez e requer login. Veja Sessão remota.

Notificações

A pílula Notifs abre a central de notificações. Você recebe um toast nativo do sistema (com fallback dentro do app) e pode ajustar preferências por tipo, além de uma janela Não Perturbe. Os tipos incluem resposta pronta, pedido de confirmação (ask user), erro de ferramenta, rotina concluída/falhou, eventos de remote e de skills, sessão expirada e atualização disponível. Veja Notificações.

Configurações

Abra Configurações para ajustar:

• Info — Nome e Organização (somente leitura), Role (Non-Developer / Developer), Tema (Dark/Light/Auto), Idioma (EN/PT), Mostrar ocultos e Autonomia.
• Plugins — recursos opcionais baixados sob demanda (Advanced Preview com LibreOffice, Mermaid, CAD Viewer, Canvas).
• Skills — as skills inclusas.
• About — versão e informações do app.

Diagnóstico e feedback

Se algo der errado, use Export Support Bundle para gerar um pacote de diagnóstico redigido (sem tokens) e /fb <mensagem> para enviar feedback à equipe. Veja Solução de problemas.

Atalhos de teclado

Atalho	Ação
Enter	Enviar mensagem
Shift+Enter	Quebrar linha
Esc	Cancelar streaming / fechar / cancelar /image
⌘/Ctrl+K	Paleta de comandos
Alt+1 / 2 / 3	Preview / Diff / Plan
Alt+4 / 5 / 6 / 7	Memory / Saved Prompts / Integrations / Run Details
⌘/Ctrl+Z	Desfazer (no canvas)
⌘/Ctrl+Enter	Enviar resposta no ask-user

A referência completa está em Atalhos do Desktop.

Veja também

⏰Rotinas

Saved Prompts vs Rotinas, agendamento e notificações.

Abrir →🔗Sessão remota

Conduza a sua sessão local de outra tela.

Abrir →🔔Notificações

A central de notificações e as preferências.

Abrir →🎤Voz

Ditar pedidos por fala→texto.

Abrir →🧰Skills

O que o agente sabe fazer e como publicar novas skills.

Abrir →⌨️Atalhos do Desktop

A tabela completa de atalhos e comandos.

Abrir →