Referência.

Comandos, MCP e os arquivos que a Ilse usa. A referência completa, com a barra, os atalhos e a compatibilidade, está no GitHub.

CLI

Sem instalar, troque ilse por npx ilse-design@latest. Para instalar: npm install -g ilse-design@latest (o mesmo comando atualiza).

  • ilse

    Sobe o seu dev server por trás da Ilse e abre o app no endereço de sempre, com a barra por cima

  • ilse --separate

    Nesta execução, abre a Ilse num endereço separado (localhost:4700); você roda o dev server

  • ilse --port 5173

    A porta em que o seu app roda (fica salva para este projeto)

  • ilse --target 3000

    A porta do dev server, se a detecção errar

  • ilse --mode mcp

    Nesta execução, as notas vão pelo MCP do seu agente (automatic | mcp | clipboard)

  • ilse --reset

    Responder de novo as perguntas do começo

  • ilse --account

    Escolher de novo qual conta do Claude este projeto usa

  • ilse --no-open

    Não abrir o navegador

  • ilse changes

    O que a Ilse mudou e ainda não tem commit

  • ilse ds

    Escreve o design system do projeto em .ilse/ds/DESIGN.md, a partir do código, sem IA

  • ilse mcp install

    Instala a Ilse no MCP dos seus agentes (Claude Code, Claude Desktop, Cursor, Codex, Gemini)

  • ilse bookmarklet

    O bookmarklet que põe a barra em qualquer página local

MCP

Com ilse mcp install (ou Configurações → Conectar agente na barra), o seu agente recebe as notas pelo chat. Ferramentas:

  • ilse_list_annotations— Lista as notas, com filtro por status
  • ilse_get_annotation— Tudo sobre uma nota
  • ilse_watch— Espera notas novas
  • ilse_resolve— Marca uma nota como resolvida
  • ilse_changes— O que a Ilse mudou e ainda não tem commit
Arquivos
~/.ilse/na sua máquina

As escolhas de cada projeto (modo, onde abrir, porta), o histórico de desfazer e os logs. Nada disso vai para o repositório.

.ilse/ds/DESIGN.mdno projeto

O design system escrito por ilse ds ou pelo botão Criar design system da Biblioteca. Pode ir para o repositório: qualquer agente lê.

.ilserc.jsonno projeto, opcional

Para apontar o typecheck e os testes que a Ilse roda depois de cada mudança, ou proteger pastas que o agente não deve editar.

{
  "check": {
    "typecheck": "pnpm typecheck",
    "test": "pnpm test --"
  },
  "protected": ["src/generated/**"]
}
© 2026 ilse. Feito com craft.