MQL5-Google-Onedrive/docs/Jules_CLI_setup.md

Jules CLI Setup

Installation

The easiest way to get started is with npm:

npm install -g @google/jules

Authentication

Before you can use the tool, you must authenticate with your Google account.

jules login

This command will open a browser window to guide you through the Google authentication process.

GitHub org + private repo access (required)

If you’re working in an organization (or on private repositories), you must also install/authorize the Jules GitHub App for the org. Installing it only on a personal account does not automatically grant access to org repos.

• Install Jules on the org account (separately):

  • In GitHub, open the organization → Settings → GitHub Apps (or “Installed GitHub Apps”).
  • Find Jules and Install it for the org.
  • Choose All repositories or explicitly select the repos Jules should access.

• Private repos need explicit permissions:

  • For private repos, the GitHub App must be granted repository access and the required permissions.
  • In practice this commonly means allowing full repo access/control (or equivalent “Repository contents” + PR permissions), otherwise Jules will not be able to read/write PRs or fetch repo contents.

Refresh Jules after GitHub authorization

After you install/approve the GitHub App permissions (especially changing org/private-repo access), refresh Jules so it re-reads the updated authorization state:

1. Close and restart Jules (exit the TUI, re-run jules, or re-run your jules new ... command).
2. If the newly-authorized repos still don’t appear or actions still fail, force a clean re-auth:

jules logout
jules login

Quick verification

Use these commands to sanity-check connectivity after setup/authorization changes:

jules version
jules remote list --repo