Jules Extension for VSCode

[]

"Experience the future of coding with Google Jules in VSCode"

Jules Extension is an extension that allows you to operate Google's AI coding agent Jules directly from within VSCode. Welcome an intelligent partner to your coding workflow.

✨ Concept

This extension was created to take your development experience to the next level.

Seamless Integration: Access the powerful features of Jules without leaving your usual VSCode environment.
Real-time Collaboration: From creating a coding session to checking its progress, everything is in real-time.
Productivity Leap: Leave the tedious tasks to Jules and focus on your creative work.

🚀 Key Features

Feature	Description	Command / Icon
Set API Key	On first use, set your API key to connect to your Jules account. The key is stored securely in VSCode's SecretStorage and used automatically for all subsequent requests.	`Jules: Set API Key`
Verify API Key	Test your API connection to ensure the key is valid and working.	`Jules: Verify API Key`
List Sources	Browse available data sources that Jules can work with.	`Jules: List Sources`
Session Management	Use the `> Jules: Create Session` command to assign a new coding task to Jules. Past sessions are also listed, allowing you to resume work or review the history of completed tasks at any time.	`Jules: Create Session`
Real-time Monitoring	Get an at-a-glance view of Jules's current work status (`Running`, `Active`, `Done`, etc.) in a dedicated sidebar view. No more switching back and forth between your browser and editor.	`julesSessionsView` (View)
Progress Update	Curious about how far Jules has progressed? Click the `↻` (refresh) button to instantly fetch and display the latest session status and activity list.	`Jules: Refresh Sessions`
Activity Display	Select a session to view detailed logs of the commands Jules has executed, files it has edited, and its thought process. It provides a transparent development experience, as if you're peering into Jules's mind.	`Jules: Show Activities`
Refresh Activities	Update the activities view for the current session to see the latest progress.	`Jules: Refresh Activities`
Send Message	Send follow-up messages to an active Jules session to provide additional instructions or feedback.	`Jules: Send Message to Session`
Approve Plan	Review and approve plans generated by Jules before execution.	`Jules: Approve Plan`
Open Settings	Open the settings for the Jules extension.	`Jules: Open Settings`
Delete Session	Delete a session from the local cache.	`Jules: Delete Session from Local Cache`
Set GitHub Token	Set your GitHub Personal Access Token for checking PR status.	`Jules: Set GitHub Token`
Clear Cache	Clear the Jules extension cache.	`Jules: Clear Cache`
Sign in to GitHub	Sign in to your GitHub account.	`Jules: Sign in to GitHub`

📦 Installation

Install from the Visual Studio Code Marketplace

Or search for "Jules Extension" in VS Code Extensions view.

From Marketplace (Recommended)

Search for "Jules Extension" in the VSCode Marketplace
Click the Install button

From VSIX File (Manual Install)

If you want to try the latest features that are not yet published on the Marketplace, you can download and install the .vsix file directly from the releases page.

Go to the Releases Page: Visit GitHub Releases and find the latest release version.
Download the VSIX File: Download the .vsix file (e.g., jules-extension-0.1.0.vsix) from the Assets.
Install in VSCode:
- Open VSCode.
- Go to the Extensions view (Ctrl+Shift+X).
- Click the ... (More Actions) menu at the top of the view and select Install from VSIX....
- Select the downloaded .vsix file to install.

Installing a Specific Version

To install a specific version of the extension:

Go to the GitHub Releases page.
Find the version you want to install and download the .vsix file from its Assets.
Follow the "Install in VSCode" steps above.

🔑 Getting Your API Key

To use the Jules Extension, you need a Jules API key. Follow these steps to get one:

Create an Account:
- Go to the Jules Official Website.
- Sign up for a new account or log in if you already have one.
Generate API Key:
- Navigate to the "API Keys" or "Developer Settings" section in your account dashboard.
- Click on "Create a new secret key".
- Give your key a descriptive name (e.g., "VSCode Extension") and generate it.
Copy Your Key:
- Your new API key will be displayed. Copy it to your clipboard.
- If you need to view your key again later, you can always find it on your Jules settings page.

Important: Treat your API key like a password. Do not share it publicly or commit it to version control.

Authentication

Use the Jules: Sign in to GitHub command.

How to use:

Command Palette (Cmd+Shift+P)
Run Jules: Sign in to GitHub
Authorize in browser

GitHub PAT (Deprecated) ⚠️

PAT support is deprecated and will be removed in a future version.

Please migrate to OAuth sign-in.

⚙️ Extension Settings

This extension contributes the following settings:

jules-extension.apiKey: Your Jules API key for authentication (stored securely).
jules-extension.autoRefresh.enabled: Enable automatic refresh of sessions list (default: false).
jules-extension.autoRefresh.interval: Auto-refresh interval in seconds (default: 60, minimum: 10).
jules-extension.autoRefresh.fastInterval: Auto-refresh interval in seconds during specific operations (e.g., branch loading). Minimum: 5. (default: 30).
jules-extension.customPrompt: A custom prompt to automatically prepend to every message sent to Jules.
jules-extension.hideClosedPRSessions: Automatically hide sessions with closed or merged pull requests from the session list (default: true).
jules.defaultBranch: Default branch selection behavior when creating a Jules session (current, default, main).

Deprecated Settings ⚠️

jules-extension.githubToken: This setting is deprecated. Use the Jules: Set GitHub Token command instead.
jules.githubPat: This setting is deprecated. Use the Jules: Sign in to GitHub command instead.

Quick Start

Press Ctrl + Shift + P (or Cmd + Shift + P) to open the Command Palette.
Run > Jules: Set Jules API Key and enter your API key.
Click the $(robot) icon in the sidebar to open the Jules Sessions View.
Run > Jules: Create Jules Session to start your first coding session!

⚠️ Important Notes

Card Block Rendering: When using features that are displayed as card blocks, please be mindful of the content's structure to ensure it renders correctly.

📚 Links

🤝 Contribution

This project is just getting started. We welcome all forms of contribution, including bug reports, feature suggestions, and pull requests! Please check the Issue Tracker and Pull Requests.

📝 License

MIT

Jules Extension

HirokiMukai