Conceitos

Estes são os blocos que formam cada fluxo do Maestrly.

Provedor e modelo

Um provedor opera o serviço de IA; um modelo é uma das opções de inferência disponibilizadas por ele. Você conecta sua própria conta ou credenciais de API do provedor. As solicitações vão direto do Maestrly ao provedor selecionado e ficam sujeitas aos termos, preços, limites e disponibilidade regional dele.

Projeto e chat

Um projeto conecta o Maestrly a uma ou mais pastas ou repositórios Git na sua máquina. Um chat é uma linha de trabalho dentro desse projeto. Ele reúne o histórico da solicitação, o modelo selecionado, o contexto de execução e as ações realizadas para aquele trabalho.

Agente e skill

Um agente é uma configuração reutilizável de trabalho: papel, instruções, modelo preferido e capacidades permitidas. Uma skill é um procedimento focado ou conjunto de orientações que o agente pode aplicar quando uma tarefa exigir. Use agentes para comportamento estável e skills para conhecimento especializado e reutilizável.

Ferramenta e MCP

Uma ferramenta permite que um agente aja ou busque informações. MCP (Model Context Protocol) é um padrão para expor ferramentas e recursos de processos locais ou serviços remotos. Cada servidor MCP conectado tem permissões, credenciais, comportamento de rede e disponibilidade próprios.

Modo de execução Git

Um chat pode trabalhar no checkout atual do projeto ou em uma worktree e branch Git isoladas. O checkout atual é útil para colaboração direta; a worktree é mais segura para tarefas paralelas ou automatizadas. O isolamento reduz conflitos, mas não substitui a revisão.

Local-first, não local-only

O Maestrly mantém a coordenação do projeto e a execução local próximas da sua máquina. Ainda existem limites de rede importantes:

prompts de IA, contexto selecionado e respostas trafegam diretamente entre o app e o provedor escolhido para inferência;
servidores MCP remotos e outros serviços conectados recebem os dados necessários para as chamadas que você autorizar;
o Maestrly não tem conta, backend hospedado, telemetria, envio automático de diagnósticos ou canal de atualização automática. Conversas, notas, configurações e registros de uso ficam no perfil local.

O Maestrly não atua como provedor de inferência nem inclui acesso aos modelos.

Uso e responsabilidade

O Maestrly é gratuito, mas provedores e serviços conectados podem cobrar nas suas próprias contas. Você controla o que conecta, o que um agente pode usar e se um resultado será aceito, commitado, integrado ou implantado.

A seguir: Visão geral dos recursos.