forked from LengKundee/MQL5-Google-Onedrive
53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
# Jules CLI Setup
|
|
|
|
## Installation
|
|
|
|
The easiest way to get started is with npm:
|
|
|
|
```shell
|
|
npm install -g @google/jules
|
|
```
|
|
|
|
## Authentication
|
|
|
|
Before you can use the tool, you must authenticate with your Google account.
|
|
|
|
```shell
|
|
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:
|
|
|
|
```shell
|
|
jules logout
|
|
jules login
|
|
```
|
|
|
|
## Quick verification
|
|
|
|
Use these commands to sanity-check connectivity after setup/authorization changes:
|
|
|
|
```shell
|
|
jules version
|
|
jules remote list --repo
|
|
```
|