⚡ Lucee CLI for CFML developers

LuCLI

/ˈluː-siː ˈɛl ˈaɪ/ • pronounced "Lucee-EL-EYE"

Run Lucee, manage servers, and execute CFML — all from your terminal.

LuCLI is a small, focused command line tool that gives you an interactive Lucee-powered terminal, one-shot commands, and simple server management without the bloat.

⬇️ Download for your OS 📖 View full documentation 🔗 View on GitHub

LuCLI terminal

$ lucli

🚀 LuCLI Terminal 0.1.234-SNAPSHOT

lucli> server start

✅ Local Lucee server running on http://localhost:8080

app $ run MyScript.cfm

✨ CFML script executed in the current directory

What is LuCLI?

LuCLI is a small command line interface built around the Lucee CFML engine. It gives you an interactive Lucee‑backed terminal, one‑shot CFML commands, and simple per‑project servers driven by a lucee.json file.

What can you do with it?

A focused set of features for everyday CFML development.

🖥️

Run CFML from your terminal

Start a Lucee‑backed terminal session, run CFML expressions, scripts and components, and keep state between commands for quick experimentation.

🌐

Per‑project Lucee servers

Spin up Lucee/Tomcat servers with a single command, configured by a lucee.json file for ports, URL rewriting, HTTPS, environments and more.

📦

Modules & automation

Package reusable CFML tools as LuCLI modules or .lucli scripts to automate tests, deployments, and maintenance tasks across projects.

📊

Monitoring & advanced tooling

Use the built‑in JMX dashboard, Java agents and rich CLI output (emoji‑aware prompts, placeholders, shell completion) to observe and debug your Lucee servers.

Getting started

Download the jar or self‑contained binary, run it with Java, and you are ready to run CFML and manage Lucee servers from your terminal.

1. Install LuCLI

Grab the latest JAR from GitHub releases:

curl -L -o lucli.jar \
https://github.com/cybersonic/LuCLI/releases/latest/download/lucli.jar

Then run it with Java (or place the self‑contained binary on your PATH to use the shorter lucli command.

2. Start a server

From your project directory, start Lucee for that folder:

                            java -jar lucli.jar server start

# once installed on PATH:
lucli server start
                        

• Open http://localhost:8080 (or the port you configured).
• Add a lucee.json file later to control ports, URL rewriting, HTTPS, environments, and more.
• Use lucli server status and lucli server log --follow to inspect and debug.

For a deeper dive into configuration, modules, and API details, head over to the full documentation.

Open LuCLI documentation →