Começar

    Pastas e dados

    Onde o Ploy guarda a configuração, as conversas, os modelos de voz e os projetos, o que o desinstalador apaga e porque nada fica em Documentos.

    Onde fica cada coisa

    O lançador dá ao Ploy pastas próprias, para ele não misturar as conversas com as de outra instalação do OpenCode.

    O quê Onde
    Configuração ~/.config/ploy
    Dados: base de dados das conversas, registos e memória ~/.local/share/ploy/opencode/
    Memória de cada conversa ~/.local/share/ploy/opencode/chats/<id>.md
    Modelo de voz ~/.local/share/ploy/models/ggml-small.bin
    Projeto predefinido ~/Projetos Ploy/Projeto Padrão
    Projetos criados pelo Nesko ~/Projetos Ploy/<nome>
    Relatórios de auditoria do Nesko ~/Projetos Ploy/Auditorias/<nome>-<data>.md
    Estado da janela (definições, cache, cookies) ~/Library/Application Support/app.ploy.desktop.dev na versão de desenvolvimento
    Registo da janela ~/Library/Logs/Ploy.log
    Registo do Ollama, quando é o lançador a iniciá-lo ~/Library/Logs/ploy-ollama.log
    Cache e estado ~/.cache/opencode e ~/.local/state/opencode
    Modelos do Ollama A pasta do próprio Ollama, por predefinição ~/.ollama

    As duas primeiras pastas podem ser trocadas com PLOY_CONFIG_DIR e PLOY_DATA_HOME. A pasta das memórias muda com PLOY_CHATS_DIR e o ficheiro do modelo de voz com PLOY_WHISPER_MODEL. A lista completa de variáveis está em Ambiente.

    A configuração

    O ficheiro opencode.json da pasta de configuração é copiado uma vez, a partir da pasta config/ do código. Define o modelo predefinido (ollama/ploy-auto, o Automático). O lançador comporta-se assim com a tua cópia:

    • se ainda é exatamente uma versão anterior que o Ploy distribuiu, é substituída pela atual, para as melhorias chegarem;
    • se a editaste, fica como está.

    As conversas e a memória

    As conversas ficam na base de dados local, dentro da pasta de dados. A memória de cada uma é também escrita num ficheiro <id>.md na subpasta chats/, e é esse ficheiro que o @ anexa a um pedido. Quando apagas uma conversa, o ficheiro da sua memória é apagado com ela. Ver Memória.

    A gravação da voz é guardada numa pasta temporária do sistema só durante a transcrição e apagada logo a seguir.

    Os projetos

    Na primeira vez que a janela abre vazia, cria o projeto predefinido em ~/Projetos Ploy/Projeto Padrão e abre aí uma conversa nova. Os projetos que o Nesko constrói ficam ao lado, em ~/Projetos Ploy/<nome>, cada um com o seu repositório git (se o git estiver disponível). Se o nome já existir, o Nesko acrescenta um número.

    Os relatórios de auditoria vão para ~/Projetos Ploy/Auditorias, nunca para dentro da pasta auditada. Se a pasta auditada for a própria Auditorias ou a pasta que a contém, o relatório vai para ~/Auditorias Ploy.

    Porque não em Documentos

    O projeto predefinido não está em Documentos por causa do macOS. A pasta Documentos é protegida por aplicação, e o serviço de uma aplicação nova fica parado até alguém responder ao diálogo de autorização. Pôr o projeto predefinido em ~/Projetos Ploy evita esse bloqueio.

    Também não é ~/Ploy. No Mac onde o Ploy é desenvolvido, o código está em ~/ploy, e o macOS não distingue maiúsculas de minúsculas: ~/Ploy seria a pasta do código.

    O que é apagado ao desinstalar

    Como o Ploy ainda não tem instalador, o comando ploy uninstall não consegue detetar o método de instalação e diz-te para removeres a instalação à mão. O que ele lista é pouco:

    • a cache, em ~/.cache/opencode;
    • o serviço em segundo plano e os terminais persistentes.

    O comando mantém as conversas, a configuração e o estado, como a própria descrição diz. Para veres o que faria antes de confirmar, corre ploy uninstall --dry-run.

    O comando não remove o Ploy.app, o atalho ploy, a pasta do código, os projetos em ~/Projetos Ploy, o modelo de voz nem os modelos do Ollama. Para tirar tudo, apaga à mão as pastas da tabela acima que quiseres remover, e liberta o espaço dos modelos com o Ollama:

    bash
    ollama rm qwen3-ploy
ollama rm qwen3:8b

    Os projetos do Nesko e os teus ficheiros de trabalho são ficheiros normais nas tuas pastas, e ficam onde estão a menos que os apagues.