jules-api

What This Skill Does

The jules-api skill provides a robust interface for interacting with Jules, Google's autonomous AI coding agent, directly through the OpenClaw agent environment. By leveraging the Jules REST API (v1alpha), this skill allows developers to automate complex coding workflows, including initializing development sessions, monitoring real-time agent activities, approving technical plans, and extracting finalized pull request URLs. It acts as a programmatic bridge between your workflow automation and Jules's ability to reason, write, and refine code within your GitHub repositories.

Installation

To install this skill, use the ClawHub CLI command: clawhub install openclaw/skills/skills/sanjacob99/jules-and-lobster

Ensure that you have generated your API key from the Jules settings dashboard at https://jules.google.com/settings#api and exported it to your environment as JULES_API_KEY. Without this variable, the skill will be unable to authenticate with the https://jules.googleapis.com/v1alpha endpoint.

Use Cases

• Automated Refactoring: Trigger Jules to perform large-scale code refactors across multiple files in a repository based on a specific prompt.
• CI/CD Integration: Automatically open a coding session when a test suite identifies a recurring failure, allowing Jules to propose a fix.
• Batch Task Management: Create sessions across multiple repositories simultaneously to keep documentation or dependencies up to date.
• Asynchronous Development: Delegate complex debugging tasks to Jules and retrieve the resulting PR URL later for final human review and merge.

Example Prompts

1. "Use the jules-api to create a new session for repo github/octocat/Hello-World, title it 'Fix build errors', and ask Jules to address the compiler warnings in the src/ folder."
2. "Check the status of session ID 12345 using the jules-api. If the status is awaiting_approval, list the proposed plan for me."
3. "Approve the plan for the active session in the project repository and provide me the PR URL once the code generation is complete."

Tips & Limitations

• Permissions: Always ensure the Jules GitHub app has been granted access to your specific repository before attempting to create a session.
• API Limits: Remember that users can have a maximum of 3 active API keys; rotate them carefully.
• Source Format: When specifying sources, always use the canonical format sources/github/owner/repo. Do not use local system environment variables for your GitHub username.
• Approval Cycles: This skill is designed for human-in-the-loop workflows; ensure you are monitoring the activities endpoint so you don't miss critical plan approvals required for Jules to proceed with commits.