Documentacao Imaginne v1.6.2

Motor de Execucao Cognitiva da [N]umbers

Instalacao

Linux/macOS

curl -fsSL https://imaginne.nnumbers.com.br/downloads/install.sh | bash

Ubuntu/Debian (APT)

sudo curl -fsSL https://imaginne.nnumbers.com.br/apt-repo/imaginne-archive-keyring.gpg -o /usr/share/keyrings/imaginne.gpg
echo "deb [signed-by=/usr/share/keyrings/imaginne.gpg] https://imaginne.nnumbers.com.br/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/imaginne.list
sudo apt update && sudo apt install imaginne

Windows (PowerShell como Administrador)

irm https://imaginne.nnumbers.com.br/downloads/install.ps1 | iex

Primeiro uso

imaginne
# Digite sua API key quando solicitado
# Obtenha em: https://imaginne.nnumbers.com.br

Configuracao salva em ~/.imaginne/config.yaml

Comandos

Comandos disponiveis na TUI

/init — Inicializar workspace

Ferramentas de Negocios & Estrategia

O Imaginne nao e apenas para desenvolvedores. Esses comandos integrados dao a profissionais de negocios, consultores e empreendedores acesso a poderosas ferramentas de analise estrategica e apresentacoes — sem necessidade de programacao.

Analise Estrategica (/strategy)

Execute analises estrategicas completas usando frameworks de negocios de classe mundial. A saida e entregue em tempo real como um relatorio detalhado e estruturado.

Frameworks Disponiveis

Uso

/strategy <framework> "seu topico"

Exemplos

/strategy swot "lancamento de um produto SaaS"
/strategy porter "mercado de ride-sharing no Brasil"
/strategy pestel "setor de energia renovavel"
/strategy blueocean "educacao online para idosos"
/strategy bcg "portfolio de produtos de um varejista medio"

Estudio de Apresentacoes (/ppt)

Gere apresentacoes .pptx completas e profissionais a partir de uma simples descricao. Escolha entre 278+ templates em 20+ categorias.

Categorias

Business, Estrategia, Tecnologia, Financas, Saude, Educacao, Marketing, Vendas, Mapas, Diagramas, Fluxogramas, SWOT, Gantt, Kanban, Linhas do Tempo, Organogramas, Infograficos, Pitch Decks, e mais.

Uso

/ppt "descricao da sua apresentacao"

Navegar & Buscar Templates

/ppt list                  # Ver todas as categorias
/ppt list strategy         # Buscar templates por palavra-chave
/ppt list finance          # Filtrar por categoria

Exemplos

/ppt "resultados de vendas Q1 2026 com graficos e KPIs"
/ppt "apresentacao de onboarding para novos funcionarios"
/ppt "pitch deck para investidores de uma fintech"

Combinando /strategy + /ppt

O verdadeiro poder vem da combinacao das duas ferramentas. Execute uma analise primeiro, depois transforme em apresentacao:

Fluxo de Trabalho

1. Execute a analise: /strategy swot "expansao para o mercado europeu"
2. Revise o resultado e refine se necessario
3. Gere a apresentacao: /ppt "apresentacao de analise SWOT para expansao no mercado europeu"
4. Baixe o arquivo .pptx e apresente para sua equipe

Esse fluxo transforma minutos de trabalho em entregaveis prontos para a diretoria — sem consultores, sem habilidades de design.

Modo Planejamento (/plan)

Ao digitar /plan, o agente entra em modo de planejamento:

1. Voce envia sua mensagem normalmente
2. O agente descreve um plano detalhado (passos, ferramentas, riscos) sem executar nada
3. Aparece uma caixa de revisao:
   • [S] Aprovar e executar o plano
   • [E] Editar — voltar ao input para dar feedback e ajustar
   • [I] Iterar — debater com outro modelo
   • [N] Cancelar o plano
4. Ao aprovar, o agente executa todos os passos de uma vez

O prompt mostra [PLAN] enquanto o modo esta ativo. Digite /plan novamente para desativar.

Atalhos de Teclado

Geral

Menus e configuracoes

Navegacao

Em menus

Modelos Disponiveis

Trocar com /model ou Ctrl+B.

Niveis de Raciocinio

Trocar com /level ou Ctrl+L.

Niveis de Autonomia

Trocar com /autonomy ou Ctrl+A.

Niveis de Verbose

Trocar com /verbose ou Ctrl+X.

Painel de Tarefas

O agente pode criar tarefas visuais durante a execucao de trabalhos complexos. As tarefas aparecem em um painel no topo da tela com status:

• ○ Pendente
• ◐ Em progresso
• ✓ Concluida

Toggle com Ctrl+T. Visivel por padrao.

Barra de Status

Na parte inferior da tela, mostra:

• Atalhos principais disponiveis
• Tokens da sessao (entrada/saida)
• Barra de uso do context window (verde < 60%, amarelo 60-80%, vermelho > 80%)

Sistema de Workspace (.imaginne/)

O Imaginne usa workspaces por diretorio. Crie uma pasta .imaginne/ na raiz do seu projeto:

projeto/
├── .imaginne/
│   ├── PROJECT.md      # Instrucoes do projeto (sempre carregado)
│   ├── RULES.yaml      # Regras e configuracoes
│   ├── MEMORY.md       # Memoria persistente do projeto
│   └── skills/         # Skills especificas do projeto
└── src/

PROJECT.md

Arquivo markdown livre com contexto do projeto:

# Meu Projeto

## Stack
- Go 1.21
- PostgreSQL
- Docker

## Convencoes
- Erros sempre wrappados com fmt.Errorf
- Testes com testify/assert
- Commits em portugues

RULES.yaml

project:
  name: meu-projeto
  language: go

rules:
  - Seguir convencoes do projeto
  - Documentar funcoes publicas
  - Escrever testes para novas features

context:
  max_tokens: "4000"
  prioritize: "recent"

MEMORY.md

Atualizado automaticamente pelo Imaginne com resumos, decisoes e referencias de sessoes anteriores.

Criar workspace

• /init default — cria estrutura com exemplos
• /init this — analisa projeto existente e gera .imaginne/ preenchido
• /project — ver info do workspace atual

Sistema de Skills

Skills sao automacoes reutilizaveis.

Localizacao

• Pessoais: ~/.imaginne/skills/
• Projeto: .imaginne/skills/

Projeto tem precedencia sobre pessoal.

Estrutura de uma Skill

~/.imaginne/skills/
└── deploy/
    ├── SKILL.yaml      # Configuracao (obrigatorio)
    └── SKILL.md        # Instrucoes (opcional)

Listar skills

/skill

Comandos de Skill

Configuracao

Arquivo de configuracao

~/.imaginne/config.yaml:

cloud:
  endpoint: "https://api.imaginne.nnumbers.com.br"
  api_key: "imn_sua_chave_aqui"

llm:
  model: "opus"
  max_tokens: 16384
  temperature: 0.7

rationalizer:
  default_level: "routine"
  auto_detect_level: true

memory:
  storage_path: "~/.imaginne/memory"
  max_context_hot: 8000
  max_context_warm: 32000

Estado da sessao

Salvo automaticamente em ~/.imaginne/session_state.json:

• Modelo selecionado
• Nivel de raciocinio
• Autonomia
• Verbose
• Thinking mode

Arquivos e Diretorios

Troubleshooting

"API key invalida"

Verifique ~/.imaginne/config.yaml e a chave em cloud.api_key.

"Workspace nao detectado"

Crie a pasta .imaginne/ na raiz do projeto:

mkdir -p .imaginne
touch .imaginne/PROJECT.md

"Skill nao encontrada"

Verifique se existe SKILL.yaml no diretorio da skill.

Resetar configuracao

rm -rf ~/.imaginne
imaginne  # Reconfigura do zero