Create a new coding session with Jules AI coding agent.

A session represents a unit of work where Jules executes a coding task on your repository.

Args:

• prompt (string, required): The task description for Jules to execute

• title (string, optional): Title for the session

• sourceContext (object, required): Repository context with:

  • source (string): Resource name like 'sources/github-owner-repo'

  • githubRepoContext (object, optional): { startingBranch: string }

• requirePlanApproval (boolean, optional): If true, plans need approval

• automationMode (string, optional): 'AUTO_CREATE_PR' to auto-create PRs

• response_format ('markdown' | 'json'): Output format

Returns: The created session with ID, state, and URL.

Examples:

• "Add unit tests for auth module" with source "sources/github-myorg-myrepo"

• Set requirePlanApproval=true to review plans before execution

List all coding sessions for the authenticated user.

Args:

• pageSize (number, optional): Results per page (1-100, default: 20)

• pageToken (string, optional): Token for pagination

• response_format ('markdown' | 'json'): Output format

Returns: List of sessions with ID, title, state, and timestamps. Includes nextPageToken if more results exist.

Examples:

• List recent sessions: no params needed

• Paginate: use pageToken from previous response

Get details of a specific coding session.

Args:

• sessionId (string, required): The session ID

• response_format ('markdown' | 'json'): Output format

Returns: Full session details including:

• State and progress

• Source context

• Outputs (pull requests if completed)

Examples:

• Get session details: sessionId="1234567"

Delete a coding session.

Args:

• sessionId (string, required): The session ID to delete

Returns: Confirmation of deletion.

Note: This action cannot be undone.

Send a message to an active Jules session.

Use this to provide feedback, answer questions, or give additional instructions while Jules is working on a task.

Args:

• sessionId (string, required): The session ID

• prompt (string, required): The message to send

Returns: Confirmation that the message was sent.

Examples:

• "Please also add integration tests"

• "Use TypeScript instead of JavaScript"

• Answer a clarifying question from Jules

Approve a pending plan in a Jules session.

Only needed when the session was created with requirePlanApproval=true. After approval, Jules will execute the planned steps.

Args:

• sessionId (string, required): The session ID with pending plan

Returns: Confirmation that the plan was approved.

Note: Check session state is 'AWAITING_PLAN_APPROVAL' before calling.

List all activities for a Jules coding session.

Activities track everything that happens during a session:

• Plan generation and approval

• User and agent messages

• Progress updates

• Completion or failure events

• Code changes and artifacts

Args:

• sessionId (string, required): The session ID

• pageSize (number, optional): Results per page (1-100, default: 20)

• pageToken (string, optional): Token for pagination

• response_format ('markdown' | 'json'): Output format

Returns: List of activities with type, description, and timestamps.

Examples:

• Monitor session progress: provide sessionId

• Get full history: paginate through all activities

Get details of a specific activity in a Jules session.

Retrieves full details including artifacts like code changes, bash output, or media files.

Args:

• sessionId (string, required): The session ID

• activityId (string, required): The activity ID

• response_format ('markdown' | 'json'): Output format

Returns: Full activity details including:

• Event type (plan generated, message, progress, etc.)

• Artifacts (code changes, command output, media)

• Timestamps

Examples:

• Get plan details: activity with planGenerated

• Get code diff: activity with changeSet artifact

List all repository sources connected to Jules.

Sources are GitHub repositories that Jules can work with. Sources are connected through the Jules web interface.

Args:

• pageSize (number, optional): Results per page (1-100, default: 20)

• pageToken (string, optional): Token for pagination

• filter (string, optional): Filter expression (e.g., 'name=sources/github-owner-repo')

• response_format ('markdown' | 'json'): Output format

Returns: List of sources with repository details:

• Owner and repo name

• Public/private status

• Available branches

Examples:

• List all repos: no params needed

• Filter by name: filter="name=sources/github-myorg-myrepo"

Get details of a specific repository source.

Retrieves full information about a connected GitHub repository including all available branches.

Args:

• sourceId (string, required): The source ID (e.g., 'github-owner-repo')

• response_format ('markdown' | 'json'): Output format

Returns: Full source details:

• Repository owner and name

• Public/private status

• Default branch

• All available branches

Examples:

• Get repo details: sourceId="github-myorg-myrepo"