jules-orchestrate

Run Google Jules coding sessions from Claude Code. Claude plans, writes tickets and reviews. Jules writes the code and opens the pull requests. CI and hands-on checks decide what merges.

Install

1. Copy this folder to .claude/skills/jules-orchestrate/ in your repository.
2. Put JULES_API_KEY=... in the repository's root .env (keep .env out of git). The key is in the Jules web app, Settings, API keys.
3. In the repository: bash .claude/skills/jules-orchestrate/scripts/jules.sh init then bash .claude/skills/jules-orchestrate/scripts/jules.sh sources and put your repository's source (sources/github/<owner>/<repo>) into jules.config.json.
4. Optional: copy PROJECT.example.md to PROJECT.md and fill in your project's facts.
5. Before the first ticket, prepare the Jules environment once: references/environment.md.

Needs Node.js (the dispatcher runs with npx tsx), git and the GitHub CLI gh.

Use

In Claude Code: /jules-orchestrate, or ask "dispatch the next Jules tickets", "status of Jules", "review the Jules PR". The loop, the review checklist and the merge rules are in SKILL.md.

Files

• SKILL.md — the loop and the hard rules
• workflows/ — feature, bugfix, review
• references/ — Jules API, environment setup, review checklist, why the loop works
• scripts/ — status, watch, review, verify, merge helpers
• dispatcher/ — the ticket queue runner (dispatch.ts) and an example config

License: MIT.