kjules

A powerful KDE6/Qt6 native desktop client written in C++ for tracking and managing Jules tasks and background processing sessions. kjules gives you a fast, native desktop experience for interacting with your Jules workflow.

When you click on a notification or open the application, it presents you with a comprehensive desktop-native version of:

• Drafts (unsubmitted)
• Queue (processing)
• Errors (failed, pending retry)
• Following (active managed sessions)
• Archive (history)
• Templates

Features

• Robust Session Management: Manage tasks across an explicit state-based workflow including Drafts (unsubmitted), Queue (processing), Errors (failed, pending retry), Following (active managed sessions), and Archive (history).
• Detailed Session Views: Dive deep into session details, view PR statuses and labels, track diffs, and read the JSON activity feed.
• Advanced Filtering: Powerful built-in filtering using a drag-and-drop AST (Abstract Syntax Tree) visual filter editor.
• System Tray Integration: Runs efficiently in the background, utilizing KDE's KNotification to deliver non-intrusive alerts for queue errors and completion events.
• Mock API Support: Includes an interactive Go-based mock API server for local testing and realistic state simulation without consuming real Jules API quotas.

Screenshots

All Sessions

Session Selection

Session Details

Activity Feed

Additional Views

Click to view more screenshots

Features

• Robust Session Management: Manage tasks across an explicit state-based workflow including Drafts (unsubmitted), Queue (processing), Errors (failed, pending retry), Following (active managed sessions), and Archive (history).
• Detailed Session Views: Dive deep into session details, view PR statuses and labels, track diffs, and read the JSON activity feed.
• Advanced Filtering: Powerful built-in filtering using a drag-and-drop AST (Abstract Syntax Tree) visual filter editor.
• System Tray Integration: Runs efficiently in the background, utilizing KDE's KNotification to deliver non-intrusive alerts for queue errors and completion events.
• Mock API Support: Includes an interactive Go-based mock API server for local testing and realistic state simulation without consuming real GitHub API quotas.

Build Instructions

Prerequisites

• C++ Compiler (C++17 support required)
• CMake (version 3.16 or higher)
• Qt 6 & KDE Frameworks 6 libraries

On Ubuntu/Debian, install the required dependencies:

sudo apt-get update && sudo apt-get install -y extra-cmake-modules qt6-base-dev qt6-tools-dev libkf6coreaddons-dev libkf6i18n-dev libkf6wallet-dev libkf6notifications-dev libkf6xmlgui-dev libkf6config-dev libkf6widgetsaddons-dev libkf6globalaccel-dev libkf6archive-dev

Building

1. Clone the repository:

   git clone https://github.com/yourusername/kjules.git
   cd kjules

2. Create a build directory:

   mkdir build
   cd build

3. Configure and build the project:

   cmake ..
   cmake --build .

   Optional: If you are doing local development, you can use the -DDEV_MODE=ON flag (e.g., cmake .. -DDEV_MODE=ON). This will automatically sandbox the application's runtime data (XDG dirs, AppData) within the project directory as .jules-dev-data/, preventing it from interfering with your normal system-wide configuration. This is highly recommended for IDE usage.

4. Run the application:

   ./kjules

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.