{"id":23764485,"url":"https://github.com/chaqchase/lla","last_synced_at":"2025-05-14T10:09:34.981Z","repository":{"id":185052241,"uuid":"672935720","full_name":"chaqchase/lla","owner":"chaqchase","description":"blazing fast `ls` replacement with superpowers","archived":false,"fork":false,"pushed_at":"2025-04-07T19:37:00.000Z","size":83884,"stargazers_count":1061,"open_issues_count":13,"forks_count":20,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-10T06:41:43.515Z","etag":null,"topics":["cli","ls","replacement","rust","terminal"],"latest_commit_sha":null,"homepage":"https://lla.chaqchase.com/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chaqchase.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-31T13:51:59.000Z","updated_at":"2025-05-09T04:41:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"45edc379-cc8a-43ef-9a3a-37f88f4114d4","html_url":"https://github.com/chaqchase/lla","commit_stats":null,"previous_names":["triyanox/lla","chaqchase/lla"],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaqchase%2Flla","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaqchase%2Flla/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaqchase%2Flla/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaqchase%2Flla/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chaqchase","download_url":"https://codeload.github.com/chaqchase/lla/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253743946,"owners_count":21957304,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","ls","replacement","rust","terminal"],"created_at":"2024-12-31T22:18:20.098Z","updated_at":"2025-05-14T10:09:34.930Z","avatar_url":"https://github.com/chaqchase.png","language":"Rust","readme":"\u003ch1\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/f7d26ac0-6d4c-4d66-9a4c-046158b20d24\" alt=\"Logo\" width=\"128\"\u003e\n  \u003cbr\u003ella\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    Modern, customizable, feature-rich and extensible `ls` replacement.\n    \u003cbr /\u003e\n    \u003ca href=\"https://lla.chaqchase.com\"\u003eDocumentation\u003c/a\u003e\n    ·\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\n    ·\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n    ·\n    \u003ca href=\"#display-formats\"\u003eDisplay Formats\u003c/a\u003e\n    ·\n    \u003ca href=\"#command-reference\"\u003eCommand Reference\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n## Overview\n\nlla is a modern `ls` replacement that transforms how developers interact with their filesystem. Built with Rust's performance capabilities and designed with user experience in mind, lla combines the familiarity of `ls` with powerful features like specialized views, Git integration, and a robust plugin system with an extensible list of plugins to add more functionality.\n\n## Features\n\n- Multiple Views: Default clean view, long format, tree structure, table layout, grid display\n- Git Integration: Built-in status visualization and repository insights\n- Advanced Organization: Timeline view, storage analysis, recursive exploration\n- Smart Search: complex filtering patterns (OR, AND, NOT, XOR), regex support\n- Customization: Plugin system, theme manager, custom shortcuts, configurable display\n- High Performance: Built with Rust, modern UI, clean listings\n- Smart Sorting: Multiple criteria, directory-first option, natural sorting\n- Flexible Config: Easy initialization, plugin management, configuration tools\n- Rich Plugin Ecosystem: File ops and metadata enhancements, code analysis, git tools, and more\n\n## Installation\n\n### Using Installation Script\n\nThe easiest way to install lla is using our installation script:\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/chaqchase/lla/main/install.sh | bash\n```\n\nThis script will automatically:\n\n- Detect your OS and architecture\n- Download the appropriate binary\n- Verify the checksum\n- Install lla to `/usr/local/bin`\n\n### Using Package Manager\n\n| Package Manager / Platform | Command             |\n| -------------------------- | ------------------- |\n| Cargo                      | `cargo install lla` |\n| macOS (Homebrew)           | `brew install lla`  |\n| Arch Linux (paru)          | `paru -S lla`       |\n| NetBSD (pkgin)             | `pkgin install lla` |\n| X-CMD                      | `x install lla`     |\n\n### Manual Installation\n\n```bash\n# Manual - Example is for amd64 GNU, replaces the file names if downloading for a different arch.\nwget -c https://github.com/triyanox/lla/releases/download/\u003cversion\u003e/\u003clla-\u003cos\u003e-\u003carch\u003e\u003e -O lla # Example /v0.3.9/lla-linux-amd64\nsudo chmod +x lla\nsudo chown root:root lla\nsudo mv lla /usr/local/bin/lla\n```\n\n### Post Installation\n\nAfter installation, initialize your setup:\n\n```bash\n# Create default config\nlla init\n\n# View your config\nlla config\n```\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/lla-ls.svg)](https://repology.org/project/lla-ls/versions)\n\n## Display Formats\n\n### Core Views\n\n#### Default View\n\nClean, distraction-free listing for quick directory scans:\n\n```bash\nlla\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/3517c63c-f4ec-4a51-ab6d-46a0ed7918f8\" className=\"rounded-2xl\" alt=\"default\" /\u003e\n\n#### Long Format\n\nRich metadata display for detailed file analysis:\n\n```bash\nlla -l\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/2a8d95e4-efd2-4bff-a905-9d9a892dc794\" className=\"rounded-2xl\" alt=\"long\" /\u003e\n\n#### Tree Structure\n\nHierarchical exploration of directory relationships:\n\n```bash\nlla -t -d 3  # Navigate up to 3 levels deep\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/cb32bfbb-eeb1-4701-889d-f3d42c7d4896\" className=\"rounded-2xl\" alt=\"tree\" /\u003e\n\n### Enhanced Organization\n\n#### Table Layout\n\nStructured view optimized for data comparison:\n\n```bash\nlla -T\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/9f1d6d97-4074-4480-b242-a6a2eace4b38\" className=\"rounded-2xl\" alt=\"table\" /\u003e\n\n#### Grid Display\n\nSpace-efficient layout for dense directories:\n\n```bash\nlla -g                  # Basic grid view\nlla -g --grid-ignore    # Grid view ignoring terminal width (Warning: may extend beyond screen)\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/b81d01ea-b830-4833-8791-7b62ff9137df\" className=\"rounded-2xl\" alt=\"grid\" /\u003e\n\n### Specialized Views\n\n#### Git Integration\n\nSmart repository insights:\n\n```bash\nlla -G\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/b0654b20-c37d-45c2-9fd0-f3399fce385e\" className=\"rounded-2xl\" alt=\"git\" /\u003e\n\n#### Timeline Organization\n\nChronological file tracking:\n\n```bash\nlla --timeline\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/06a156a7-628a-4948-b75c-a0da584c9224\" className=\"rounded-2xl\" alt=\"timeline\" /\u003e\n\n#### Storage Analysis\n\nVisual disk usage insights:\n\n```bash\nlla -S # use --include-dirs to calculate directories sizes\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/dad703ec-ef23-460b-9b9c-b5c5d6595300\" className=\"rounded-2xl\" alt=\"sizemap\" /\u003e\n\n### Advanced Navigation\n\n#### Fuzzy Search (Experimental)\n\nInteractive file discovery:\n\n```bash\nlla --fuzzy\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/ec946fd2-34d7-40b7-b951-ffd9c4009ad6\" className=\"rounded-2xl\" alt=\"fuzzy\" /\u003e\n\n#### Deep Directory Exploration (Recursive)\n\nComprehensive subdirectory listing:\n\n```bash\nlla -R\nlla -R -d 3  # Set exploration depth\n```\n\n\u003cimg src=\"https://github.com/user-attachments/assets/f8fa0901-8866-4b92-a76e-3b7fd307f04e\" className=\"rounded-2xl\" alt=\"recursive\" /\u003e\n\nThe `-R` option can be integrated with other options to create a more specific view. For example, `lla -R -l`\nwill show a detailed listing of all files and directories in the current directory.\n\n## Command Reference\n\n### Display Options\n\n#### Basic Views\n\n| Command   | Short | Description                                                                                                       | Example  |\n| --------- | ----- | ----------------------------------------------------------------------------------------------------------------- | -------- |\n| (default) |       | List current directory                                                                                            | `lla`    |\n| `--long`  | `-l`  | Detailed file information with metadata                                                                           | `lla -l` |\n| `--tree`  | `-t`  | Hierarchical directory visualization                                                                              | `lla -t` |\n| `--table` | `-T`  | Structured data display                                                                                           | `lla -T` |\n| `--grid`  | `-g`  | Organized grid layout you can use `-g --grid-ignore` to ignore terminal width (Warning: may extend beyond screen) | `lla -g` |\n\n#### Advanced Views\n\n| Command       | Short | Description                             | Example                               |\n| ------------- | ----- | --------------------------------------- | ------------------------------------- |\n| `--sizemap`   | `-S`  | Visual representation of file sizes     | `lla -S` \u003cbr\u003e `lla -S --include-dirs` |\n| `--timeline`  |       | Group files by time periods             | `lla --timeline`                      |\n| `--git`       | `-G`  | Show git status and information         | `lla -G`                              |\n| `--fuzzy`     | `-F`  | Interactive fuzzy finder (Experimental) | `lla --fuzzy`                         |\n| `--recursive` | `-R`  | Recursive listing format                | `lla -R` \u003cbr\u003e `lla -R -d 3`           |\n\n#### Display Modifiers\n\n| Command               | Description                                                                           | Example                         |\n| --------------------- | ------------------------------------------------------------------------------------- | ------------------------------- |\n| `--icons`             | Show icons for files and directories                                                  | `lla --icons`                   |\n| `--no-icons`          | Hide icons for files and directories                                                  | `lla --no-icons`                |\n| `--no-color`          | Disable all colors in the output                                                      | `lla --no-color`                |\n| `--permission-format` | Set the format for displaying permissions (symbolic, octal, binary, verbose, compact) | `lla --permission-format octal` |\n\n### Sort \u0026 Filter Options\n\n#### Sorting\n\n| Command                 | Short | Description                                  | Example                                             |\n| ----------------------- | ----- | -------------------------------------------- | --------------------------------------------------- |\n| `--sort`                | `-s`  | Sort files by criteria                       | `lla -s name` \u003cbr\u003e `lla -s size` \u003cbr\u003e `lla -s date` |\n| `--sort-reverse`        | `-r`  | Reverse the sort order                       | `lla -s size -r`                                    |\n| `--sort-dirs-first`     |       | List directories before files                | `lla --sort-dirs-first`                             |\n| `--sort-case-sensitive` |       | Enable case-sensitive sorting                | `lla --sort-case-sensitive`                         |\n| `--sort-natural`        |       | Natural number sorting (2.txt before 10.txt) | `lla --sort-natural`                                |\n\n#### Basic Filtering\n\n| Command            | Short | Description                     | Example                             |\n| ------------------ | ----- | ------------------------------- | ----------------------------------- |\n| `--filter`         | `-f`  | Filter files by pattern         | `lla -f \"test\"` \u003cbr\u003e `lla -f \".rs\"` |\n| `--case-sensitive` | `-c`  | Enable case-sensitive filtering | `lla -f \"test\" -c`                  |\n| `--depth`          | `-d`  | Set the depth for tree listing  | `lla -t -d 3` \u003cbr\u003e `lla -d 2`       |\n\n#### Advanced Filtering Patterns\n\n| Filter Type        | Example                       | Description                                    |\n| ------------------ | ----------------------------- | ---------------------------------------------- |\n| OR Operation       | `lla -f \"test,spec\"`          | Match files containing either \"test\" or \"spec\" |\n| AND Operation      | `lla -f \"+test,api\"`          | Match files containing both \"test\" and \"api\"   |\n| Regular Expression | `lla -f \"regex:^test.*\\.rs$\"` | Rust files starting with \"test\"                |\n| Glob Pattern       | `lla -f \"glob:*.{rs,toml}\"`   | Match .rs or .toml files                       |\n| Composite AND      | `lla -f \"test AND .rs\"`       | Logical AND operation                          |\n| Composite OR       | `lla -f \"test OR spec\"`       | Logical OR operation                           |\n| Composite NOT      | `lla -f \"NOT test\"`           | Logical NOT operation                          |\n| Composite XOR      | `lla -f \"test XOR spec\"`      | Logical XOR operation                          |\n\n### View Filters\n\n#### Show Only Filters\n\n| Command           | Description                         | Example               |\n| ----------------- | ----------------------------------- | --------------------- |\n| `--dirs-only`     | Show only directories               | `lla --dirs-only`     |\n| `--files-only`    | Show only regular files             | `lla --files-only`    |\n| `--symlinks-only` | Show only symbolic links            | `lla --symlinks-only` |\n| `--dotfiles-only` | Show only dot files and directories | `lla --dotfiles-only` |\n\n#### Hide Filters\n\n| Command         | Description                    | Example             |\n| --------------- | ------------------------------ | ------------------- |\n| `--no-dirs`     | Hide directories               | `lla --no-dirs`     |\n| `--no-files`    | Hide regular files             | `lla --no-files`    |\n| `--no-symlinks` | Hide symbolic links            | `lla --no-symlinks` |\n| `--no-dotfiles` | Hide dot files and directories | `lla --no-dotfiles` |\n\n#### Combined Filters\n\n| Description                                  | Example                           |\n| -------------------------------------------- | --------------------------------- |\n| Show only dot directories                    | `lla --dirs-only --dotfiles-only` |\n| Show only regular files, excluding dot files | `lla --files-only --no-dotfiles`  |\n\n### Plugin Management\n\n#### Installation\n\n| Command         | Description                  | Example                                            |\n| --------------- | ---------------------------- | -------------------------------------------------- |\n| `install --git` | Install from Git repository  | `lla install --git https://github.com/user/plugin` |\n| `install --dir` | Install from local directory | `lla install --dir path/to/plugin`                 |\n\n#### Plugin Controls\n\n| Command            | Description                | Example                                                                       |\n| ------------------ | -------------------------- | ----------------------------------------------------------------------------- |\n| `use`              | Interactive plugin manager | `lla use`                                                                     |\n| `--enable-plugin`  | Enable specific plugins    | `lla --enable-plugin name`                                                    |\n| `--disable-plugin` | Disable specific plugins   | `lla --disable-plugin name`                                                   |\n| `update`           | Update plugins             | `lla update` \u003cbr\u003e `lla update file_tagger`                                    |\n| `plugin`           | Run plugin actions         | `lla plugin --name file_tagger --action add-tag --args README.md \"important\"` |\n\n#### Shortcut Management\n\n| Command           | Description        | Example                                                           |\n| ----------------- | ------------------ | ----------------------------------------------------------------- |\n| `shortcut add`    | Add a new shortcut | `lla shortcut add find file_finder search -d \"Quick file search\"` |\n| `shortcut remove` | Remove a shortcut  | `lla shortcut remove find`                                        |\n| `shortcut list`   | List all shortcuts | `lla shortcut list`                                               |\n\n### Configuration \u0026 Setup\n\n| Command         | Description                       | Example                                                                         |\n| --------------- | --------------------------------- | ------------------------------------------------------------------------------- |\n| `init`          | Initialize the configuration file | `lla init`                                                                      |\n| `config`        | View or modify configuration      | `lla config`                                                                    |\n| `theme`         | Interactive theme manager         | `lla theme`                                                                     |\n| `theme pull`    | Pull the built-in themes          | `lla theme pull`                                                                |\n| `theme install` | Install theme from file/directory | `lla theme install /path/to/theme.toml`\u003cbr\u003e`lla theme install /path/to/themes/` |\n| `completion`    | Generate shell completion scripts | `lla completion bash`                                                           |\n| `clean`         | Clean up invalid plugins          | `lla clean`                                                                     |\n\n### General Options\n\n| Command     | Short | Description               |\n| ----------- | ----- | ------------------------- |\n| `--help`    | `-h`  | Print help information    |\n| `--version` | `-V`  | Print version information |\n\n\u003e **Note**\n\u003e For detailed usage and examples of each command, visit the [lla documentation](https://lla.chaqchase.com).\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","funding_links":[],"categories":["Rust"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaqchase%2Flla","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchaqchase%2Flla","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaqchase%2Flla/lists"}