AI-Powered Terminal Assistant

Lumo CLI - Navigate the terminal with natural language

Lumo CLI is an open-source terminal assistant that interprets natural language to help you navigate the command line with ease, execute complex tasks, and understand command outputs.

Available Now

Get Started View on GitHub

Powerful Features

Enhance Your Terminal Experience

Lumo combines AI-powered capabilities with practical terminal utilities to boost your productivity.

Natural Language Command Processing

Ask questions in plain English and get the exact terminal commands you need, with detailed explanations.

Example

$ lumo "How do I find large files in Linux?"

Terminal Agent Mode

Let Lumo CLI execute sequences of terminal commands to complete complex tasks with interactive planning and execution.

Example

$ lumo auto:create a backup of my documents folder

Multi-Provider Support

Choose between Google Gemini, OpenAI, or Ollama for local AI inference without internet connectivity.

Example

$ lumo config:provider set openai

Chat Mode

Have conversational interactions with Lumo to get help with technical concepts and terminal usage.

Example

$ lumo chat

System Health Monitoring

Check system health, generate reports, and monitor performance with simple natural language commands.

Example

$ lumo health:memory

File Transfer

Transfer files between computers on your local network with a simple, intuitive interface.

Example

$ lumo connect --receive

Pipe Support

Pipe command outputs to Lumo for analysis, explanations, and insights about complex terminal output.

Example

$ cat error.log | lumo

View All Features

Interactive Demo

See Lumo CLI in Action

Watch how Lumo CLI helps you navigate the terminal with natural language.

Try It Yourself

Lumo CLI makes complex terminal tasks simple with natural language commands.

Natural Language Queries

Ask questions in plain English and get the exact commands you need.

Terminal Agent Mode

Let Lumo CLI execute sequences of terminal commands to complete complex tasks.

System Health Monitoring

Check system health and get detailed reports with simple commands.

View Documentation

Command Reference

Explore the full range of commands available in Lumo.

Basic Usage

The simplest way to use Lumo is by asking questions in natural language.

Natural Language Queries

Ask questions in plain English and get the exact terminal commands you need.

$ lumo "How do I find large files in Linux?"

$ lumo "How to use grep with multiple patterns?"

$ lumo "What's the difference between TCP and UDP?"

Command Line Options

Basic command line options for Lumo.

$ lumo --help

$ lumo -h

$ lumo --version

$ lumo -v

Terminal Agent Mode

Let Lumo CLI execute sequences of terminal commands to complete complex tasks.

Automated Terminal Tasks

Execute a sequence of terminal commands as an agent.

$ lumo auto:create a backup of my documents folder

$ lumo agent:find all large files in the current directory and show their types

$ lumo agent:set up a python virtual environment with flask and sqlalchemy

$ lumo agent:monitor CPU and memory usage every 5 seconds

Terminal Agent Commands

Commands available in interactive terminal agent mode.

run

refine <prompt>

add <command>

edit <num>

delete <num>

move <num> <pos>

help

exit

Chat Mode

Have conversational interactions with Lumo.

Starting Chat

Start or continue a conversation with Lumo.

$ lumo chat

$ lumo chat:Tell me about Linux file permissions

$ lumo ask:What is the capital of France?

Chat Commands

Commands available in interactive chat mode.

help

clear

history

new

list

switch <num>

delete <num>

exit

System Commands

Check system health and generate reports.

Health Checks

Commands for checking system health.

$ lumo health

$ lumo system

$ lumo health:memory

$ lumo health:disk

$ lumo health:cpu

$ lumo health:network

System Reports

Generate detailed system reports.

$ lumo report:performance

$ lumo report:security

$ lumo report:storage

Shell Commands

Execute shell commands directly.

$ lumo lumo:ls -la

$ lumo shell:find . -name "*.go" -type f

Pipe Support

Pipe command outputs to Lumo for analysis.

Analyzing Output

Analyze piped input from other commands.

ls -la | lumo

cat error.log | lumo

ps aux | grep python | lumo

dmesg | lumo

File Transfer

Transfer files between computers on your local network.

Server Mode

Start a server to receive files.

$ lumo connect --receive

$ lumo connect --receive --port 9000

$ lumo connect --receive --path /tmp

Client Mode

Connect to a peer to send files.

$ lumo connect 192.168.1.5

$ lumo connect 192.168.1.5:9000

$ lumo connect 192.168.1.5 --path /tmp

Additional Features

Other useful features and commands.

Internet Speed Testing

Test your internet connection speed.

$ lumo speed

$ lumo speed:download

$ lumo speed:upload

$ lumo "check my internet speed"

Clipboard Operations

Manage clipboard content.

$ lumo clipboard

$ lumo clipboard "Hello World"

$ lumo clipboard append "More text"

$ lumo clipboard clear

echo "This is some text" | lumo clipboard

Magic Commands

Fun terminal animations and commands.

$ lumo magic:dance

$ lumo magic:help

Configuration

Configure Lumo settings.

$ lumo config:provider list

$ lumo config:provider show

$ lumo config:provider set openai

$ lumo config:api set

Installation

Get Started in Minutes

Choose the installation method that works best for you and start using Lumo right away.

Platform Support

Linux

Supported

macOS

Supported

Windows

Supported

Using Pre-built Binaries

The recommended quick approach is to use pre-built binaries for your platform.

# Using pre-built binary (Linux)
curl -L https://github.com/agnath18K/lumo_cli/releases/download/v1.0.1/lumo_1.1.0_linux_amd64.tar.gz -o lumo.tar.gz
tar -xzf lumo.tar.gz
sudo mv lumo /usr/local/bin/

# Using Debian package
curl -L https://github.com/agnath18K/lumo_cli/releases/download/v1.0.1/lumo_1.0.1_amd64.deb -o lumo.deb
sudo dpkg -i lumo.deb

# Verify the installation
lumo --version

Install from Source

Building from source ensures you have the latest features and improvements.

# From source
git clone https://github.com/agnath18K/lumo_cli.git
cd lumo_cli
make build
sudo make install

# Verify the installation
lumo --version

Note: You'll need Go 1.22 or higher installed on your system to build from source.

Ready to Transform Your Terminal Experience?

Get started with Lumo CLI today and navigate the terminal with the power of natural language.

Natural language command processing
Terminal agent mode for complex tasks
Multi-provider AI support
System health monitoring
Pipe support for command analysis
Chat mode for conversational help

Install Lumo CLI View on GitHub

terminal

$ lumo "How do I get started with Lumo CLI?"

To get started with Lumo CLI, follow these simple steps:

1. Install Lumo CLI using one of these methods:
- Recommended quick approach (pre-built binary): curl -L https://github.com/agnath18K/lumo_cli/releases/download/v1.0.1/lumo_1.0.1_linux_amd64.tar.gz -o lumo.tar.gz && tar -xzf lumo.tar.gz && sudo mv lumo /usr/local/bin/
- From source: git clone https://github.com/agnath18K/lumo_cli.git && cd lumo_cli && make build && sudo make install

2. Run the setup to configure your AI provider:
lumo setup

3. Start using Lumo CLI with natural language:
lumo "How do I find large files in Linux?"

Would you like to see more examples?