A native Android client for Google Jules, with a Gemini-powered coding copilot. The app lets you start and manage Jules coding sessions from an Android device.
- Create coding sessions for a connected GitHub source and branch.
- Browse sessions, inspect session activity, send follow-up messages, and delete sessions.
- Review and approve a Jules-generated plan when plan approval is enabled.
- Use a Gemini-powered copilot with Jules-related tool actions.
- Sign in with Google through Firebase Authentication or continue in guest mode.
- Save and sync prompt-gallery entries with Cloud Firestore when Firebase is configured.
- Adjust app theme and Gemini model preferences in Settings.
- Kotlin and Jetpack Compose with Material 3
- Android Gradle Plugin and Gradle Kotlin DSL
- Retrofit, OkHttp, and Moshi for REST APIs and JSON
- Google Jules REST API
- Gemini API
- Firebase Authentication and Cloud Firestore
- Kotlin coroutines and Flow
The main source code is under app/src/main/java/com/example/.
| Package or file | Responsibility |
|---|---|
MainActivity.kt |
Android activity and Compose app entry point |
ui/screens/ |
Welcome/authentication, chat home, session details, settings, and prompt gallery screens |
ui/components/ and ui/theme/ |
Reusable Compose UI, theme, colors, and typography |
viewmodel/JulesAppViewModel.kt |
UI state, screen navigation, and coordination between UI and data/services |
jules/sdk/ |
Jules API client, request/response models, and session/source operations |
gemini/ |
Gemini-powered copilot logic, API service, and Gemini request/response models |
data/auth/ |
Firebase Authentication and Google sign-in |
data/firestore/ |
Cloud Firestore synchronization for saved prompts |
data/preferences/ |
Local preferences such as API key, selected model, theme, and session defaults |
At a high level, Compose screens observe state exposed by the ViewModel. The ViewModel coordinates Jules API requests through the Jules SDK, Gemini copilot requests through the Gemini service, and authentication or saved-prompt synchronization through Firebase-backed data classes. Local UI preferences are stored with Android SharedPreferences.
- Android Studio with support for the Android SDK Platform 36
- JDK 17 for the Gradle build (the GitHub Actions workflow uses Temurin JDK 17)
- Git and network access to download Gradle and Android dependencies
- A Google Jules API key to use Jules sessions
- A Gemini API key to use the Gemini-powered copilot
- A Firebase project with Google sign-in configured if you want Google authentication and cloud-synced saved prompts
The project uses the Gradle wrapper, configured for Gradle 9.3.1. You do not need to install Gradle separately.
The Secrets Gradle Plugin reads .env and uses .env.example as its default properties file. From the repository root, create a local environment file:
cp .env.example .envOpen .env and replace the placeholder with a valid Gemini API key:
GEMINI_API_KEY=YOUR_GEMINI_API_KEYDo not leave the placeholder value in place if you want Gemini requests to work. Keep .env local; it is listed in .gitignore. Never commit a real API key. If you are working in Google AI Studio, follow its Secrets configuration flow instead of copying a real key into source-controlled files.
Get a key and read the setup guide in the Gemini API documentation.
Firebase configuration is not included in this repository. To configure Google sign-in and cloud-synced saved prompts:
- Create or select a project in the Firebase console.
- Register an Android app using the application ID
com.aistudio.jules.ashikfromapp/build.gradle.kts. - Enable the Google sign-in provider in Firebase Authentication.
- Configure the OAuth client for your app and ensure the generated configuration includes the web OAuth client ID used by Google sign-in.
- Download
google-services.jsonand place it atapp/google-services.json. - Enable and configure Cloud Firestore for the Firebase project if you need saved-prompt synchronization.
Use the official Firebase Android setup guide, Google Services configuration guide, and Credential Manager Google sign-in guide.
The app's Gradle configuration allows a build to proceed when google-services.json is missing. The app can also launch in guest mode without a configured Firebase default app; Google sign-in will return a clear configuration error, and cloud-synced prompts will be unavailable until Firebase is configured. To enable these features, complete the Firebase setup above and install the matching app/google-services.json. The configuration must match application ID com.aistudio.jules.ashik and include the web OAuth client ID used by Google sign-in. A successful debug build does not verify Firebase runtime configuration.
Firebase configuration files contain project-specific identifiers. Follow your team's repository policy for them, and never commit private credentials, service-account keys, passwords, or API keys.
Run the app, open Settings, and enter your Jules API key in the API-key setting. The app stores this value in local app preferences. The preference value is Base64-encoded, which is not encryption; protect access to your device and do not share the key or include it in screenshots, logs, or commits.
Create or manage a key through the official Jules API documentation. The Jules API also requires the relevant GitHub source to be connected to Jules before the app can create sessions for that source.
- Clone the repository and open its root directory in Android Studio.
- Install the required Android SDK Platform 36 if Android Studio prompts you.
- Set the Gradle JDK to JDK 17 in Android Studio's Gradle settings.
- Complete the configuration steps above for the services you intend to use.
- Wait for Gradle sync to finish, then select Build > Make Project or Build > Build Bundle(s) / APK(s) > Build APK(s).
The debug APK is normally written to:
app/build/outputs/apk/debug/app-debug.apk
From the repository root, build the debug APK with the Gradle wrapper.
macOS / Linux:
chmod +x ./gradlew
./gradlew assembleDebugWindows (Command Prompt):
gradlew.bat assembleDebugThe output APK is at app/build/outputs/apk/debug/app-debug.apk. These commands build the debug variant; they do not claim that tests or lint checks have passed.
The GitHub Actions build workflow runs on pushes and pull requests targeting main or master, and can also be started manually. It uses JDK 17 and runs ./gradlew assembleDebug; the resulting debug APK is uploaded as a workflow artifact. The workflow currently verifies the debug build rather than running automated test tasks. Open the workflow run in the repository's Actions tab to inspect its result and download the artifact.
- Gemini requests fail: Check that
.envexists in the repository root,GEMINI_API_KEYcontains a valid key rather than the example placeholder, and Gradle sync/build completed after the change. - Google sign-in reports that it is not configured: Check that
app/google-services.jsonmatches application IDcom.aistudio.jules.ashik, Google sign-in is enabled in Firebase Authentication, and the configuration provides a web OAuth client ID. - Firebase features fail at runtime: Confirm that the Firebase project and the required Authentication/Firestore services are configured. A successful debug build alone does not verify Firebase runtime configuration.
- Gradle cannot find a Java runtime or fails during sync: Configure JDK 17 as the Gradle JDK, then sync again.
- Android SDK or platform errors appear: Install Android SDK Platform 36 in Android Studio's SDK Manager and retry the build.
- Jules requests fail: Check the API key entered in app Settings and make sure the intended GitHub repository is connected to Jules.
Bug reports and focused improvements are welcome. When opening an issue, include the steps to reproduce the problem, the expected behavior, and relevant error output with secrets and personal data removed. For a change proposal, describe the intended behavior and keep the pull request focused.
No root-level license file was found in the repository when this README was prepared. This README does not make any claim about the project's license; check with the maintainers before reusing or redistributing the code.