Jules SDKBLOCK

An SDK for running a fleet of coding agents in the Cloud

Orchestrate complex, long-running coding tasks to an ephemeral cloud environment integrated with a GitHub repo.

Send work to a Cloud based session

import { jules } from '@google/jules-sdk';

const session = await jules.session({
prompt: `Fix visibility issues in the examples/nextjs app.

**Visibility issues**
- White text on white backgrounds
- Low contrast on button hover

**Instructions**
- Update the global styles and page components to a dark theme with the shadcn zinc palette.
`,
source: { github: 'davideast/dataprompt', baseBranch: 'main' },
autoPr: true,
});

Monitor agent progress

import { jules } from '@google/jules-sdk';

const session = jules.session('');

for await (const activity of session.stream()) {
switch (activity.type) {
case 'planGenerated':
console.log(`${activity.plan.steps.length} steps.`);
break;
case 'progressUpdated':
console.log(`${activity.title}`);
// Check for code updates
for (const artifact of activity.artifacts) {
if (artifact.type === 'changeSet') {
const parsed = artifact.parsed();
for (const file of parsed.files) {
console.log(`${file.path}: +${file.additions} -${file.deletions}`);
}
}
}
break;
case 'sessionCompleted':
console.log('Session finished successfully.');
break;
}
}

// Get the pull-request URL once complete
const outcome = await session.result();
if (outcome.pullRequest) {
console.log(`PR: ${outcome.pullRequest.url}`);
}

Installation

npm i @google/jules-sdk
export JULES_API_KEY=

Core Features

Run Cloud Functions with a Coding Agent

Jules sessions run in the cloud and can run without a GitHub repository. We call these "Repoless" sessions. They are incredibly powerful because they act like preconfigured serverless functions. The J