⚡ LOGICROOT

Your Linux Command Center.

A powerful, terminal-first Linux system monitor, diagnostics suite, process manager, service controller, storage analyzer, and AI-powered troubleshooting assistant.

Monitor · Diagnose · Manage · Understand

🧠 What is LOGICROOT?

LOGICROOT is a modern Linux command center built entirely for the terminal.

Instead of switching between:

htop
systemctl
du
df
ip
journalctl
nvidia-smi
ps
top

LOGICROOT brings the most useful Linux system operations into a single, consistent interface.

                         ┌──────────────────────┐
                         │        LOGICROOT           │
                         │  Linux Command Center │
                         └──────────┬───────────┘
                                    │
             ┌──────────────────────┼──────────────────────┐
             │                      │                      │
        MONITOR                  MANAGE                DIAGNOSE
             │                      │                      │
       CPU / RAM               Processes              Problems
       GPU / Disk              Services               Health
       Network                 Storage                Boot
       Temperature             Logs                   System
             │                      │                      │
             └──────────────────────┼──────────────────────┘
                                    │
                              🧠 AI Assistant

LOGICROOT is designed to be:

• ⚡ Fast
• 🐧 Linux-native
• 🛡️ Safe
• 🔒 Local-first
• 🧩 Modular
• 🎨 Beautiful in the terminal
• 🤖 AI-enhanced
• 🛠️ Developer-friendly

✨ Features

logicroot services
logicroot services start nginx
logicroot services stop nginx
logicroot services restart nginx

✓ CPU
⚠ MEMORY
✓ GPU
⚠ DISK
✓ NETWORK
⚠ SERVICES

logicroot ask "Why is my laptop slow?"

🎬 Terminal Demo

Example:

╭────────────────────────────────────────────────────────────╮
│                         LOGICROOT                                │
│                  Linux Command Center                       │
├────────────────────────────────────────────────────────────┤
│                                                            │
│  CPU       ███████░░░  67%        GPU       ███░░░░░░ 31% │
│  RAM       ██████░░░░  61%        DISK      ███████░░░ 72% │
│  TEMP                  52°C        NETWORK   ↓ 4.2 MB/s    │
│                                                            │
├────────────────────────────────────────────────────────────┤
│ SYSTEM                                                     │
│                                                            │
│ OS       Fedora Linux                                      │
│ Kernel   6.x                                               │
│ Uptime   4h 32m                                            │
│                                                            │
├────────────────────────────────────────────────────────────┤
│ QUICK ACTIONS                                              │
│                                                            │
│  [1] Processes     [2] Services      [3] Storage           │
│  [4] Network       [5] GPU            [6] Diagnostics       │
│  [7] Logs          [8] Cleanup        [9] Assistant         │
│                                                            │
│  ? Help                                             q Quit  │
╰────────────────────────────────────────────────────────────╯

🚀 Quick Start

Requirements

• Linux
• Python 3.11+
• pip / pipx
• systemd is recommended but not mandatory

Optional tools:

systemctl
nvidia-smi
journalctl
ip
ping

LOGICROOT gracefully handles missing optional tools.

Installation

Using pipx

pipx install logicroot

From source:

logicroot

From source

git clone https://github.com/madhav-manchanda/linx.git

cd logicroot

python -m venv .venv

source .venv/bin/activate

pip install -e .

With the interactive dashboard:

logicroot

Commands

logicroot

System information:

logicroot status

Processes:

logicroot processes

Sort processes by CPU:

logicroot processes --sort cpu

Sort by memory:

logicroot processes --sort memory

Search processes:

logicroot processes --search chrome

⚙️ Services

List services:

logicroot services

Failed services:

logicroot services --failed

Restart a service:

logicroot services restart bluetooth

Stop a service:

logicroot services stop nginx

Start a service:

logicroot services start nginx

LOGICROOT always asks for confirmation before potentially disruptive actions.

💾 Storage

Analyze your filesystem:

logicroot storage

Find large files:

logicroot storage large

Find duplicate files:

logicroot storage duplicates

Analyze caches:

logicroot storage cache

🌐 Network

Network overview:

logicroot network

Interfaces:

logicroot network interfaces

Active connections:

logicroot network connections

Ping:

logicroot network ping google.com

🎮 GPU

Check GPU information:

logicroot gpu

Example:

GPU
──────────────────────────────────

NVIDIA RTX 3050

Utilization       41%
VRAM              2.8 / 4 GB
Temperature       53°C
Power             37 W

Processes
──────────────────────────────────

python            1.7 GB
chrome            410 MB

🩺 Diagnostics

Run a complete system diagnosis:

logicroot diagnose

Example:

LOGICROOT DIAGNOSTICS
──────────────────────────────────────

✓ CPU
  Normal

⚠ MEMORY
  RAM usage is 91%

  Top consumers:
  chrome      5.8 GB
  code        2.1 GB

⚠ DISK
  /home is 94% full

✓ GPU
  Normal

⚠ SERVICES
  1 failed service

✓ NETWORK
  Connected

──────────────────────────────────────

3 potential issues detected.

LOGICROOT provides suggestions rather than blindly modifying the system.

🤖 AI Assistant

LOGICROOT can optionally provide AI-powered diagnostics.

Ask:

logicroot ask "Why is my laptop slow?"

Or:

logicroot ask "What is using most of my RAM?"

Or:

logicroot ask "Why is my boot taking so long?"

LOGICROOT collects relevant system metrics and provides a contextual explanation.

Example:

LOGICROOT ANALYSIS
────────────────────────────────────────

Your system is experiencing high memory usage.

RAM:
5.8 GB  Chrome
2.1 GB  VS Code
1.7 GB  Python

Available RAM:
1.4 GB

Possible actions:

1. Close unused browser tabs
2. Inspect the Python process
3. Check swap usage

No changes were made to your system.

🛡️ Safety First

LOGICROOT is designed around least privilege.

It does not require:

sudo logicroot

for normal monitoring.

Destructive or disruptive actions always require confirmation.

For example:

⚠ WARNING

You are about to stop:

docker.service

This may stop running containers.

Continue? [y/N]

LOGICROOT never silently:

• deletes files
• kills processes
• stops services
• modifies configuration
• executes AI-generated commands

🔒 Privacy

LOGICROOT is local-first.

Core functionality does not require:

• accounts
• cloud services
• remote servers
• databases
• internet access

AI functionality is optional.

When AI mode is enabled, only the relevant system context required for the request should be sent to the configured AI provider.

LOGICROOT must never intentionally send:

• passwords
• API keys
• SSH keys
• tokens
• environment secrets
• private file contents

🏗️ Architecture

                         ┌─────────────────────┐
                         │        LOGICROOT         │
                         │       CLI/TUI       │
                         └──────────┬──────────┘
                                    │
                    ┌───────────────┴───────────────┐
                    │                               │
              CLI Interface                   TUI Interface
                    │                               │
                    └───────────────┬───────────────┘
                                    │
                              Core Services
                                    │
       ┌──────────────┬─────────────┼──────────────┬──────────────┐
       │              │             │              │              │
     System       Processes      Services        Storage       Network
       │              │             │              │              │
       └──────────────┴─────────────┼──────────────┴──────────────┘
                                    │
                              GPU / Hardware
                                    │
                              Diagnostics
                                    │
                              AI Assistant
                                    │
                             Linux Kernel / OS

📁 Project Structure

logicroot/
│
├── src/
│   └── logicroot/
│       │
│       ├── cli.py
│       ├── config.py
│       ├── exceptions.py
│       │
│       ├── core/
│       │
│       ├── system/
│       │
│       ├── processes/
│       │
│       ├── services/
│       │
│       ├── storage/
│       │
│       ├── network/
│       │
│       ├── gpu/
│       │
│       ├── diagnostics/
│       │
│       ├── logs/
│       │
│       ├── cleanup/
│       │
│       ├── assistant/
│       │
│       ├── ui/
│       │
│       └── utils/
│
├── tests/
│
├── assets/
│   ├── demo.gif
│   ├── dashboard.gif
│   └── screenshots/
│
├── pyproject.toml
├── README.md
├── LICENSE
├── CONTRIBUTING.md
└── SECURITY.md

🧰 Technology Stack

🐧 Linux Compatibility

LOGICROOT is designed with distribution portability in mind.

Target environments:

Fedora
Ubuntu
Debian
Arch Linux
Nobara
openSUSE

The application should use portable Linux interfaces whenever possible.

Distribution-specific functionality is isolated behind adapters.

PackageManager
│
├── Dnf
├── Apt
├── Pacman
└── Zypper

🧪 Testing

Run:

pytest

Run with coverage:

pytest --cov=logicroot

The test suite should not depend on the developer's actual hardware.

System interfaces are mocked where appropriate.

🛠️ Development

Clone:

git clone https://github.com/madhav-manchanda/linx.git

cd logicroot

Create environment:

python -m venv .venv
source .venv/bin/activate

Install development dependencies:

pip install -e ".[dev]"

Run LOGICROOT:

logicroot

Run tests:

pytest

🗺️ Roadmap

LOGICROOT DEVELOPMENT ROADMAP

                    COMPLETE
                       │
                       ▼
              ┌─────────────────┐
              │ CLI Foundation  │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ System Monitor  │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ Process Manager │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ Service Manager │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ Storage Engine  │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ Network Monitor │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │  GPU Monitor    │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │  Diagnostics    │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │   TUI Dashboard │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │  AI Assistant   │
              └────────┬────────┘
                       │
                       ▼
                     🚀
                  LOGICROOT 1.0

Planned

• System dashboard
• Process manager
• systemd service manager
• Storage analyzer
• Network monitor
• GPU monitoring
• Log viewer
• Diagnostics engine
• Cleanup assistant
• Interactive TUI
• AI troubleshooting
• JSON output
• Plugin architecture
• Package manager integration
• Docker/Podman monitoring
• SMART disk health
• Battery health
• Remote Linux monitoring

🧩 Future Plugin Architecture

LOGICROOT is intended to become extensible.

Future versions may support:

logicroot plugins

with modules such as:

logicroot-docker
logicroot-podman
logicroot-smart
logicroot-battery
logicroot-firewall
logicroot-backup
logicroot-kubernetes

The core application should remain lightweight while optional functionality can be added independently.

⌨️ Keyboard Shortcuts

Inside the TUI:

┌──────────────────────────────┐
│ LOGICROOT SHORTCUTS               │
├──────────────────────────────┤
│ 1    Dashboard               │
│ 2    Processes               │
│ 3    Services                │
│ 4    Storage                 │
│ 5    Network                 │
│ 6    GPU                     │
│ 7    Logs                    │
│ 8    Diagnostics             │
│ 9    Cleanup                 │
│ A    AI Assistant            │
│ R    Refresh                 │
│ /    Search                  │
│ ?    Help                    │
│ Q    Quit                    │
└──────────────────────────────┘

🎯 Design Philosophy

LOGICROOT follows five principles:

01 — Local First

Your system information belongs on your system.

02 — Safe by Default

Nothing destructive happens without explicit confirmation.

03 — Beautiful Terminal UX

The terminal doesn't have to look boring.

04 — Linux Native

Use Linux's actual interfaces instead of reinventing them.

05 — Explain, Don't Just Display

LOGICROOT should not merely say:

RAM: 91%

It should eventually explain:

RAM usage is high.

Chrome is consuming 5.8 GB,
VS Code is consuming 2.1 GB,
and available memory is 1.4 GB.

Here is what you can investigate.

🌟 Why LOGICROOT?

Linux already provides incredible tools.

The problem is that information is fragmented.

          Linux System
               │
      ┌────────┼─────────┐
      │        │         │
     top    systemctl   df
      │        │         │
     ps      journalctl  du
      │        │         │
     ip     nvidia-smi  free
      │        │         │
      └────────┼─────────┘
               │
               ▼
          ┌──────────┐
          │   LOGICROOT   │
          └──────────┘
               │
               ▼
      One consistent interface

LOGICROOT doesn't try to replace Linux.

It brings Linux's capabilities together.

🤝 Contributing

Contributions are welcome.

Before opening a pull request:

pytest

Please keep contributions:

• modular
• tested
• documented
• Linux-compatible
• secure

For major architectural changes, open an issue first.

🔐 Security

If you discover a security vulnerability, please do not publicly disclose it immediately.

See:

SECURITY.md

for the responsible disclosure process.

📄 License

This project is licensed under the MIT License.

See LICENSE.

⚡ LOGICROOT

Monitor. Diagnose. Manage. Understand.

$ logicroot

Everything about your Linux system.
One terminal.
One command center.

Built for Linux. Built in the terminal. Built to be useful.