jules-tools-skill

# Jules Tools Skill

This skill allows the AI agent to interface with the **Jules Tools CLI** to manage Google's Jules AI coding sessions. With this skill, the agent can start new coding sessions, list active sessions, and retrieve results directly from the terminal.

## Prerequisites

Before using any Jules commands, ensure the `jules` CLI is installed and authenticated.

### 1. Installation

Check if `jules` is installed by running:

```bash
jules --version
```

If the command is not found, install it using `npm`:

```bash
npm install -g @google/jules
```

> **Note:** Installation might require `sudo` permissions depending on the system configuration. If `npm install -g` fails due to permissions, try `sudo npm install -g @google/jules` or ask the user for assistance.

### 2. Authentication

The agent must be authenticated to interact with Jules. To authenticate, run:

```bash
jules login
```

This command will open a browser window for the user to sign in with their Google account. If the agent is running in a headless environment, guide the user to perform this step on their local machine or provide alternative authentication methods if available (refer to `jules login --help`).

To verify authentication or log out, use:

```bash
jules logout
```

## Usage

The primary command for interacting with Jules is `jules remote`.

### List Sessions

To see all active or past coding sessions:

```bash
jules remote list --session
```

To list connected repositories:

```bash
jules remote list --repo
```

### Start a New Session

To start a new coding session (task) for Jules:

```bash
jules remote new --repo <repo_name> --session "<task_description>"
```

- `<repo_name>`: The repository name (e.g., `torvalds/linux`) or `.` for the current directory's repo.
- `<task_description>`: A clear description of what Jules should do (e.g., "Fix the bug in the login handler").

**Example:**

```bash
jules remote new --repo . --session "Add a new test case for the user profile compone...

# Jules Tools Skill for OpenClaw

This repository contains an **OpenClaw AgentSkill** that enables AI agents to interface with the [Jules Tools CLI](https://jules.google/docs/cli/reference/). This allows your AI assistant to manage Google's Jules coding sessions, including starting new tasks, listing sessions, and retrieving code changes.

## Features

- **Installation Check**: Verifies if the `jules` CLI is installed and guides the installation if needed.
- **Authentication**: Provides instructions for logging in with your Google account.
- **Session Management**: Supports listing, creating, and pulling results from remote coding sessions.

## Installation

To add this skill to your OpenClaw agent:

1.  **Clone or Copy**: Place the `jules-tools-skill` directory into your OpenClaw skills directory (typically `skills/` or `~/.openclaw/skills/`).

    ```bash
    cp -r jules-tools-skill ~/.openclaw/skills/
    ```

2.  **Restart OpenClaw**: Restart your OpenClaw agent to load the new skill.

3.  **Verify**: Ask your agent "List my Jules sessions" or "Help me install Jules Tools" to verify the skill is active.

## Usage

Once installed, you can interact with the skill through natural language commands to your agent.

**Examples:**

- "Install Jules Tools CLI."
- "Login to Jules."
- "Start a new coding session to fix the login bug in this repo."
- "List my active Jules sessions."
- "Pull the changes from session 12345."

## Requirements

- **OpenClaw**: A running instance of OpenClaw (or compatible agent framework).
- **Node.js & npm**: Required to install the `@google/jules` package.
- **Google Account**: Required for authentication with Jules.

## License

This project is licensed under the MIT License.