Primeiros passos

O Maestrly é um aplicativo desktop para macOS, Windows e Linux que funciona como um centro de comando para seus agentes de IA de codificação. Ele orquestra as CLIs de IA de codificação que você já usa — tudo num só lugar — com quadros Kanban, terminais integrados, revisão de código e muito mais. O Maestrly nunca inclui nem revende acesso a nenhum modelo de IA: você usa sua própria assinatura com cada provedor, e seu código e suas credenciais ficam na sua máquina.

Este guia leva você da instalação até a sua primeira conversa.

1. Instalar o app

Baixe o instalador do Maestrly para o seu sistema operacional (macOS, Windows ou Linux) e siga os passos de instalação padrão. Na primeira vez que você abrir, o app inicia um breve tour de boas-vindas.

2. Fazer login

O Maestrly faz seu login com Google ou GitHub. Na tela de boas-vindas, escolha "Entrar com Google" ou "Entrar com GitHub", autorize o acesso e você será levado de volta ao app. Nenhuma senha extra é criada — você usa o login social da sua conta existente.

3. Configurar suas CLIs de IA de codificação

O Maestrly conduz as ferramentas de linha de comando de IA de codificação que rodam na sua máquina — use as suas. Abra as Configurações (o ícone de engrenagem na barra lateral): o Maestrly detecta automaticamente quais CLIs suportadas estão instaladas no seu sistema. Garanta que as ferramentas que você quer usar estejam instaladas e autenticadas com suas próprias credenciais antes de iniciar um agente. Cada ferramenta mantém suas próprias credenciais no keychain do seu sistema; o Maestrly apenas as orquestra.

4. Criar um workspace

Um workspace é um repositório Git — o projeto em que os agentes trabalham. Abra a barra lateral, clique em Adicionar workspace e aponte para a pasta do seu projeto. Cada conversa que você inicia nasce na sua própria branch/worktree isolada, então agentes diferentes não pisam no trabalho uns dos outros.

5. Iniciar sua primeira conversa

Dentro de um workspace, crie uma nova conversa. Escolha qual CLI vai atendê-la e a branch em que trabalhar; o Maestrly sobe a interface de terminal daquela ferramenta e você já começa a conversar com o agente. O agente trabalha diretamente nos arquivos do seu projeto, no seu computador. Você pode rodar várias conversas em paralelo, cada uma isolada na sua própria branch.

6. Organizar o trabalho com quadros

Todo workspace tem um quadro Kanban. Crie cards para tarefas, mova-os entre colunas e configure colunas "agente" que iniciam automaticamente uma nova conversa quando um card chega. É uma forma prática de montar um pipeline de desenvolvimento assistido por IA — produzir, revisar e entregar.

Próximos passos

• Conceitos — entenda workspaces, conversas, handoff e como notas, memória e busca de entregas se diferenciam.
• Visão geral dos recursos — conheça a gaveta da conversa e o kit avançado.

Travou? Acesse o Suporte para ver as opções de contato, incluindo reportar problemas direto do app.