LazyEdit - The Effortless TUI Code Editor

When you're too lazy to open a full IDE, but too productive for Notepad.

Code editing shouldn't be hard work. Be lazy. Be efficient.

LazyEdit is a lightweight, terminal-based code editor with an integrated PowerShell terminal designed for developers who want a streamlined editing experience without leaving the command line.

✨ Features

• All-in-One Interface: File browser, text editor, and PowerShell terminal in a single window
• Keyboard-Driven: Navigate and edit efficiently with intuitive keyboard shortcuts
• Syntax Highlighting: Makes your code more readable and easier to understand
• Integrated Terminal: Run commands without switching applications
• Lightweight: Minimal resource usage compared to full IDEs
• Windows-Optimized: Built specifically for Windows with PowerShell integration

📋 Table of Contents

• Installation
• Quick Start
• Usage Guide
• Keyboard Shortcuts
• Development
• License

🚀 Installation

requirements

• Chocolatey
• pip

pip install lazyedit

That's it! No complex setup or configuration required.

If it fails to run your Python Scripts folder might not be in the system PATH.

Run Temporary:

$env:Path += ";C:\Users\YourUserName\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\Scripts"

Run Permanent:

[System.Environment]::GetEnvironmentVariable("Path", "User") -split ";" | Out-File -FilePath "$env:TEMP\PathBackup.txt"
[System.Environment]::SetEnvironmentVariable("Path", $newPath, "User")
$newPath = [System.Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Users\YourUserName\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\Scripts"

Optional lazyGit when u want to use git feature and didn't download

choco install lazygit

Optional lazyDocker when u want to use docker feature and didn't download

choco install lazydocker

If you don’t see the "default" context, set it manually:

docker context use default

Now try running lazyedit again.

🏃‍♂️ Quick Start

After installation, simply run:

lazyedit

You'll be greeted with a three-panel interface:

• Left panel: File browser
• Main panel: Text editor
• Bottom panel: PowerShell terminal

📖 Usage Guide

File Navigation

• Use Directory Mode (Ctrl+2) to browse files
• Navigate with arrow keys to select a file
• Press Space to open the selected file in the editor
• Press Enter to create a new file
• Press Backspace to delete a file

Editing Files

• Switch to File Editing Mode (Ctrl+3) to edit the opened file
• Use standard keyboard navigation (arrows, Home, End) to move around
• Save your changes with Ctrl+S

Using the Terminal

• Switch to Terminal Mode (Ctrl+5) to use the PowerShell terminal
• Execute commands as you would in a normal PowerShell window
• The terminal shows your current directory relative to where LazyEdit was launched

🐙 Git Integration

lazyedit by Jesse Duffield : lazygit LazyEdit includes LazyGit for effortless repository management.

Launching LazyGit

• Switch to Git Mode using Ctrl+g.
• This opens LazyGit in a separate floating window.
• You can manage branches, commits, merges, and pull requests from LazyGit without leaving LazyEdit.

Common Git Commands via LazyGit

🐙 Docker Integration

lazydocker by Jesse Duffield : lazydocker LazyDocker includes LazyDocker for effortless docker management.

Launching LazyDocker

• Switch to Docker Mode using Ctrl+d.
• This opens LazyDocker in a separate floating window.
• You can manage containers, images, volumes, merges, and networks from LazyDocker without leaving LazyEdit.

Common Docker Commands via LazyDocker

⌨️ Keyboard Shortcuts

General Shortcuts

📂 Directory Mode

📝 File Editing Mode

💻 Terminal Mode

💻 Development

Want to contribute or run from source? Follow these steps:

# Clone the repository
git clone https://github.com/Robbevanherpe1/lazyedit.git
cd lazyedit

# Create and activate development environment
hatch env create
hatch shell

# Install in development mode
pip install -e .

# Run LazyEdit
lazyedit

Project Structure

lazyedit/
├── src/
│   └── lazyedit/
│       ├── __init__.py
│       ├── __about__.py
|       ├── lazydocker_screen.py # Lazydocker screen integration
|       ├── lazygit_screen.py    # Lazygit screen integration
│       ├── directory.py         # File browser functionality
│       ├── fileEditor.py        # Text editing functionality
│       ├── gui.py               # Main application interface
│       └── terminal.py          # PowerShell terminal integration
├── tests/
│       ├── directory/
│       ├── fileEdit/
│       ├── terminal/
│       ├── __init__.py
│       └── test_basic.py
├── pyproject.toml
├── README.md
└── LICENSE.txt

📝 License

LazyEdit is distributed under the terms of the EPL license.

Made with ❤️ by *Robbe

Inspiration by Jesse Duffield's lazygit and lazydocker