# Café Gemini CLI

Bem-vindo ao Café Gemini, seu **parceiro de desenvolvimento colaborativo** para o ecossistema Godot. Prepare sua xícara, porque a jornada do código será deliciosa!

O Café Gemini transforma o Gemini em um copiloto que tem acesso direto e total ao seu ambiente de desenvolvimento. Em vez de você precisar copiar e colar código para obter ajuda, o Café Gemini já tem acesso a todo o seu projeto, incluindo scripts, cenas e a arquitetura geral do seu jogo.

Ele é, em essência, o Gemini para desenvolvedores Godot, e o melhor de tudo: **roda diretamente no seu celular via Termux!**

## Comandos da Ferramenta

O Café Gemini vem com um conjunto de comandos para agilizar seu desenvolvimento:

-   `cafe-gemini` ou `repo-cafe`:
    -   **Função:** Inicia a sessão de chat com o assistente. `repo-cafe` é um alias para `cafe-gemini`.
    -   **Uso:** `cafe-gemini`

-   `cafe-new [template] <nome-do-projeto>`:
    -   **Função:** Te serve um novo "Café Quentinho" (um projeto Godot com base nos templates do Café).
    -   **Argumentos:**
        -   `template` (opcional): Especifique `headless`, `platformer` ou `topdown`. Se não especificar, o template `headless` será usado por padrão.
            -   **`headless` (Padrão):** A base perfeita para qualquer projeto. Inclui todos os sistemas essenciais (menus, save, áudio, configurações, tradução) sem nenhuma mecânica de jogo específica. Ideal para começar um novo jogo do zero ou para adaptar a um projeto existente.
            -   **`platformer`:** Uma especialização do `headless`, adicionando mecânicas de jogo de plataforma 2D.
            -   **`topdown`:** Uma especialização do `headless`, adicionando mecânicas de jogo de aventura com visão de cima (Top-Down).
    -   **Exemplos de Uso:**
        -   `cafe-new meu-novo-jogo` (cria um projeto a partir do `headless`)
        -   `cafe-new platformer meu-jogo-plataforma`
        -   `cafe-new topdown meu-jogo-topdown`

-   `cafe-gemini-update`:
    -   **Função:** Atualiza a ferramenta `cafe-gemini` para a versão mais recente. O processo de atualização também garante que sua cópia local do Repo-Café esteja sincronizada com a versão da ferramenta.
    -   **Uso:** `cafe-gemini-update`

-   `repo-update`:
    -   **Função:** Atualiza especificamente o repositório de conhecimento (Repo-Café), baixando as últimas atualizações dos manuais. É ideal para obter o conteúdo mais recente, que pode ser atualizado com mais frequência do que a ferramenta em si.
    -   **Uso:** `repo-update`

-   `cafe-rename`:
    -   **Função:** Renomeia arquivos e pastas recursivamente para um formato limpo e consistente, ideal para Godot e sistemas de controle de versão. Preserva maiúsculas/minúsculas e hífens, mas troca espaços por `_` e remove acentos/caracteres especiais. **Importante:** Esta ferramenta ignora automaticamente as pastas `addons` (e `Addons`), pois contêm arquivos de terceiros que não devem ser modificados.
    -   **Uso:** `cafe-rename --source <caminho-opcional>`

## Como Funciona?

O Café Gemini é um wrapper inteligente para o `gemini-cli` do Google. Ele utiliza o repositório [Repo Café](https://github.com/Cafe-GameDev/Repo-Cafe) — um curso completo de Godot em formato de texto — como uma base de conhecimento fixa. É o nosso grão especial, sempre moído na hora para o seu projeto, garantindo um aroma único em cada linha de código.

É importante ressaltar que, embora o Café Gemini seja escrito em Node.js, suas ferramentas são desenvolvidas especificamente para auxiliar desenvolvedores de jogos Godot. Isso significa que você, como desenvolvedor de jogos, pode utilizar as funcionalidades do Café Gemini diretamente em seus projetos Godot, mesmo sem ter experiência prévia com Node.js. Eu sou o engenheiro dos scripts, o balconista mestre que cria utilitários em Node.js para resolver problemas práticos do seu dia a dia no desenvolvimento de jogos Godot.

## Instalação

Para instalar o Café Gemini, você precisa ter o [Node.js](https://nodejs.org/) (que inclui o NPM) instalado em seu sistema.

Com o Node.js pronto, abra seu terminal e execute o seguinte comando:

```bash
npm install -g cafe-gemini
```

E pronto! Seu café está coado e pronto para ser saboreado, seja um espresso rápido ou um coado demorado.

## Como Usar

Após a instalação, simplesmente abra um novo terminal e execute:

```bash
cafe-gemini
```

É só dar um gole e começar a codificar, sentindo a cafeína do desenvolvimento fluir!

## Recursos Adicionais

-   **Análise de Mídia**: O Gemini pode "ver" e analisar arquivos de imagem e áudio do seu projeto. Ele tem um olfato apurado para os detalhes, como um sommelier de café, identificando cada nuance do seu projeto.

## Modo de Operação de Conteúdo (NSFW)

Para garantir total liberdade criativa em projetos destinados a um público adulto, o Café Gemini possui um modo de operação explícito (NSFW). É a sua dose extra de cafeína para a criatividade sem limites, como um café duplo para as ideias mais ousadas.

-   **Modo Padrão (SFW):** Por padrão, o assistente opera com as políticas de segurança de conteúdo do Google, evitando temas sensíveis.
-   **Modo Explícito (NSFW):** Se um arquivo chamado `NSFW` (sem extensão) for detectado na raiz do seu projeto, as restrições de conteúdo são suspensas. Isso permite que o assistente colabore na criação de diálogos com linguagem explícita, descrições de violência e outros temas maduros, respeitando a visão criativa do seu projeto.

Se você solicitar um conteúdo que seria bloqueado, o próprio assistente oferecerá a criação do arquivo `NSFW` para ativar o modo explícito.