lazygradle 1.1.8

A TUI for managing and running your Gradle tasks

lazygradle

A TUI for managing and running your Gradle tasks
Explore the docs »

Report Bug · Request Feature

About The Project

LazyGradle is a Terminal User Interface (TUI) application for managing and running Gradle tasks.

Main interface showing task list and details

Manage multiple Gradle projects

Run Gradle tasks

Run Gradle tasks with parameters

Features:

• Manage multiple Gradle projects
• View all available tasks with descriptions
• Run tasks with or without parameters
• Real-time task output streaming
• Configuration persistence
• Dark mode
• Keyboard navigation
• Task execution history tracking

(back to top)

Built With

• 
• 

(back to top)

Getting Started

To get LazyGradle up and running on your local machine, follow these simple steps.

Prerequisites

• Python 3.13 or higher
• A Gradle project (with gradlew wrapper or system gradle installed)

Installation

Via pip

pip install lazygradle

Manually

1. Clone the repository

   git clone https://github.com/jacob-sabella/lazygradle.git
   

2. Navigate to the project directory

   cd lazygradle
   

3. Create and activate a virtual environment

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

4. Install dependencies

   pip install -r requirements.txt
   

5. Run the application

   python app.py
   

Optional Logging

Logging is disabled by default. To enable file logging, set LAZYGRADLE_LOG_FILE.

LAZYGRADLE_LOG_FILE=1 python app.py

That writes logs to lazygradleapp.log in the current directory. You can also provide an explicit path:

LAZYGRADLE_LOG_FILE=~/.local/state/lazygradle/app.log python app.py

LAZYGRADLE_LOG_LEVEL is also supported and defaults to DEBUG when logging is enabled.

(back to top)

Usage

First Launch

When you first launch LazyGradle, you'll need to add a Gradle project:

1. Press p to open the project chooser
2. Add your Gradle project directory
3. LazyGradle will automatically detect and cache all available tasks

Keyboard Shortcuts

• p - Open project chooser (switch between projects or add new ones)
• d - Toggle dark mode
• r - Run the selected task
• R - Run the selected task with custom parameters
• Tab / Shift+Tab - Navigate between UI elements
• ↑ / ↓ - Navigate task list

Running Tasks

1. Select a task from the list on the left
2. View the task description on the right
3. Press r to run, or R to run with parameters
4. Watch the real-time output in the output panel

Managing Projects

LazyGradle stores your project configurations in ~/.config/lazygradle/gradle_cache.json, so your projects and their task lists are remembered between sessions.

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Acknowledgments

• Textual - The amazing TUI framework that powers LazyGradle
• Best-README-Template - For this README template
• Shields.io - For the badges

(back to top)

AI Usage in Development

The ability to get this project to a usable state in my free time was definitely made possible through the help of Generative AI tooling to assist with development. This has included the following.

• Claude Code (CLAUDE.MD file included in project)
• ChatGPT Web
• opencode

I do have plans to clean up much of the AI generated comments and code to graduate it a bit above "AI slop" status where its present, but it's certainly been a higher priority for me to get something working and usable for my other purposes (which is primarily Sockbowl development).

(back to top)