// Documentação do Singularity
O que é o Singularity?
O Singularity é um IDE de ambiente de trabalho que reúne o código, o Git, os terminais e os agentes de IA num único espaço de trabalho nativo.
O que é o Singularity
O Singularity é um IDE de ambiente de trabalho construído com Electron. Reúne os terminais, os espaços de trabalho, o editor de código, o Git, um quadro Kanban e a orquestração de agentes de IA numa única aplicação nativa.
A proposta é simples: não controlas os agentes num separador à parte. Eles trabalham dentro do projeto, com os respetivos ficheiros e o histórico Git, enquanto tu manténs à vista o contexto, o acompanhamento e a revisão.

A quem se destina
O Singularity destina-se a programadores e pequenas equipas que delegam trabalho a agentes de IA sem abdicar do controlo do resultado. O código, a revisão, o Git e o progresso ficam no mesmo sítio, desde o pedido inicial até à integração.
Os grandes componentes
- Workbench: o posto de comando que compõe todas as superfícies de trabalho.
- Espaços de trabalho: a organização dos teus projetos e repositórios.
- Editor: a escrita, a navegação e a compreensão do código.
- Git: o estado do repositório, as alterações e as operações correntes.
- Terminal: sessões de shell integradas no contexto do projeto.
- Kanban & orquestração: o acompanhamento dos tickets e a execução do trabalho pelos agentes.
- Definições: a configuração da aplicação e dos respetivos fornecedores de IA.
- Marketplace: a instalação e a gestão dos módulos disponíveis.
Como ler esta documentação
A ordem da navegação lateral é a ordem de leitura recomendada: começa pela instalação e pelos primeiros passos, descobre depois a interface e, por fim, aprofunda cada ferramenta.
Cada página é verificada com uma versão específica da aplicação. As menções Revisto com (reviewed) e versão da aplicação (appVersion) aparecem no rodapé para poderes avaliar a atualidade das instruções.
Perguntas frequentes
O Singularity substitui o meu IDE?
O Singularity pode servir de IDE principal graças ao seu editor, aos seus terminais, às suas ferramentas Git e aos seus espaços de trabalho. Também o podes adotar de forma progressiva, a par das tuas ferramentas atuais: trabalha diretamente sobre os mesmos projetos e repositórios.
Que modelos de IA são suportados?
O Singularity orquestra os fornecedores de IA cujo CLI configuras na aplicação. A disponibilidade e as capacidades dependem, portanto, dos fornecedores instalados e das respetivas contas, e não de um modelo imposto pelo Singularity.
Os meus ficheiros são enviados para algum lado?
A aplicação é nativa e os seus dados residem numa base de dados SQLite local. O Singularity não envia os teus ficheiros para nenhum serviço intermediário; apenas os CLI dos fornecedores de IA que configurares podem comunicar para fora do teu computador, de acordo com as suas próprias definições e políticas.