J Jules

Native Jules API client

Review Jules sessions, chat with the agent, and inspect code changes from a Flutter app.

Jules is a polished cross-platform client for developers who want a native interface for Jules sessions, plans, activity timelines, generated patches, and local account switching.

View repository Start locally
Jules Flutter client in light mode Jules Flutter client in dark mode

What Jules helps with

The app wraps the Jules API in a local-first desktop and mobile experience: add a named API key, browse repositories returned by the sources API, start sessions, follow activity, approve generated plans, continue conversations, and review generated patches.

Features

Multi-account setup

Store named Jules API keys locally and switch between accounts without rebuilding the app.

Repository-first sessions

Create new sessions against GitHub repositories returned by the Jules sources endpoint.

Activity timeline

Read user messages, agent responses, plan events, progress updates, and system activity.

Plan approval

Approve generated plans from the app when a session is waiting for review.

Diff review

Inspect generated change sets, patches, suggested commit messages, and command output.

Local cache

Keep sessions and activities responsive with Hive-backed local storage and background sync.

Quickstart

Install Flutter, clone the repository, fetch dependencies, and run the macOS client from the repository root. 

git clone https://github.com/CkCreative/flutter_native_jules.git
cd flutter_native_jules
cd jules_flutter
flutter pub get
cd ..
npm run dev

Available commands

npm run dev Run the app on macOS.
npm run dev:ios Run on a connected iOS device.
npm run dev:simulator Run on the active iOS simulator.
npm run dev:android Run on Android.
npm run analyze Run Flutter static analysis.

Typical workflow

  1. Add an account name and Jules API key on first launch.
  2. Sync repositories from the Jules sources API.
  3. Start a session with a prompt and repository context.
  4. Review the generated plan and approve it when ready.
  5. Follow progress, continue the chat, and inspect generated diffs.

Support the project

If Jules is useful, star the repository and share it with developers who want a native client for Jules API workflows.

Star on GitHub