Laurenfeminine36/google-jules-skill

O que google-jules-skill faz?

Controla sessões do Google Jules via API REST e CLI, permitindo gerenciamento de sessões, verificações de status, instruções, relatórios, merges e encerramentos a partir de agentes LLM.

Visão Geral

Esta skill fornece uma interface unificada para que agentes de IA (como Claude Code, Cursor, Codex) interajam com o Google Jules. Ela expõe operações essenciais para gerenciar o ciclo de vida de sessões do Jules, incluindo:

• Gerenciamento de Sessões: Criar, listar e encerrar sessões.
• Status: Verificar o status de uma sessão específica ou geral.
• Instruções: Enviar instruções para o assistente de codificação Jules.
• Relatórios: Obter relatórios de progresso da sessão atual.
• Merge: Realizar merge de branches associados a uma sessão.
• Encerramento: Fechar sessões e liberar recursos.

Como Usar

Pré-requisitos

• Token de acesso ou chave de API para autenticação no Google Jules.
• URL base da API (ex: https://jules.googleapis.com ou endpoint personalizado).

Instalação

A skill pode ser carregada em agentes compatíveis (Claude Code, Cursor, Codex). Siga as instruções do seu agente para adicionar o repositório Laurenfeminine36/google-jules-skill.

Comandos

Todos os comandos suportam saída em formato JSON ou tabela (padrão: JSON).

Gerenciar Sessões

# Criar uma nova sessão
jules session create --name "minha-sessao" --branch "feature/nova-func"

# Listar sessões ativas
jules session list

# Obter detalhes de uma sessão
jules session get --id "session-123"

Status e Instruções

# Verificar status da sessão
jules status --session-id "session-123"

# Enviar instrução para o assistente
jules instruct --session-id "session-123" --message "Refatore a função de login"

Relatórios e Merge

# Obter relatório de progresso
jules report --session-id "session-123" --format json

# Realizar merge da branch da sessão
jules merge --session-id "session-123" --target "main"

Encerrar

# Fechar sessão
jules session close --id "session-123"

Exemplo de Fluxo Completo

1. Criar uma sessão:

   jules session create --name "fix-bug-123" --branch "hotfix/123"
   

2. Enviar instrução:

   jules instruct --session-id "session-abc" --message "Corrigir erro de validação no formulário de contato"
   

3. Aguardar conclusão (opcional, via polling do status).

4. Gerar relatório:

   jules report --session-id "session-abc" --format table
   

5. Fazer merge:

   jules merge --session-id "session-abc" --target "main"
   

6. Fechar sessão:

   jules session close --id "session-abc"
   

Documentação da API

A skill utiliza os seguintes endpoints REST (configuráveis via variáveis de ambiente):

Método	Endpoint	Descrição
POST	/sessions	Criar nova sessão
GET	/sessions/{id}	Obter detalhes da sessão
GET	/sessions	Listar sessões
POST	/sessions/{id}/instructions	Enviar instrução
GET	/sessions/{id}/report	Obter relatório
POST	/sessions/{id}/merge	Realizar merge
DELETE	/sessions/{id}	Fechar sessão

Variáveis de Ambiente

• JULES_API_BASE_URL: URL base da API (padrão: https://jules.googleapis.com)
• JULES_ACCESS_TOKEN: Token de acesso para autenticação
• JULES_API_KEY: Chave de API alternativa (usada se JULES_ACCESS_TOKEN não estiver definido)

Suporte

Esta skill foi testada com:

• Claude Code (Anthropic)
• Cursor (Cursor AI)
• Codex (GitHub Copilot)

Para problemas ou sugestões, abra uma issue no repositório do GitHub.

Licença

MIT