Configuration
lla configuration
Customizing lla
lla is configurable. Use these options to match your workflow.
Quick Setup
Your configuration lives at ~/.config/lla/config.toml. Get started with:
lla init # Create your config
lla config # View current settingsCore Settings
Key settings:
# Essential Behaviors
default_sort = "name" # name, size, or date
default_format = "default" # default, long, tree, etc.
show_icons = true # Enable file icons
include_dirs = false # Show directory sizes
theme = "default" # Your chosen theme
default_depth = 3 # Directory traversal depth
# Visual Organization
[sort]
dirs_first = false # Directories before files
case_sensitive = false # Case-sensitive sorting
natural = true # Smart number sorting
# Search Preferences
[filter]
case_sensitive = false # Case-sensitive search
no_dotfiles = false # Hide hidden files
# Plugin Aliases (v0.5.0+)
[plugin_aliases]
j = "jwt" # lla plugin j decode
k = "kill_process" # lla plugin k interactive
n = "npm" # lla plugin n search "react"
gs = "google_search" # lla plugin gs "query"
yt = "youtube" # lla plugin yt search "video"
# Performance Tuning
[formatters.tree]
max_lines = 20000 # Tree view limit
[listers.recursive]
max_entries = 20000 # Recursive listing limit
# Grid formatter configuration
[formatters.grid]
# Whether to ignore terminal width by default
ignore_width = false
# Maximum width for grid view when ignore_width is true
max_width = 200
[formatters.long]
hide_group = false # Hide the group column
relative_dates = false # Show dates like "2h ago"
[listers.fuzzy]
ignore_patterns = [ # Fuzzy search exclusions
"node_modules",
"target",
".git",
".idea",
".vscode"
]Display Formats
Choose your default view:
default: Clean, efficient listinglong: Detailed metadata viewtree: Hierarchical structuregrid: Space-optimized layoutgit: Repository insightstimeline: Time-based groupingsizemap: Storage visualizationtable: Structured data view
Command-Line Configuration
Quickly adjust settings without editing files:
# Core preferences
lla config --set default_sort size
lla config --set default_format long
lla config --set show_icons true
# Sorting behavior
lla config --set sort.dirs_first true
lla config --set sort.case_sensitive true
# Search preferences
lla config --set filter.case_sensitive true
lla config --set filter.no_dotfiles truePlugin Aliases
Plugin aliases let you create short names for frequently used plugins (v0.5.0+).
Configuring Aliases
Add aliases to your config file:
[plugin_aliases]
j = "jwt"
k = "kill_process"
n = "npm"
gs = "google_search"
yt = "youtube"
gm = "google_meet"Using Aliases
Aliases work with all plugin commands:
# Without alias
lla plugin jwt decode "token123"
lla plugin kill_process interactive
lla plugin npm search "react"
# With alias
lla plugin j decode "token123"
lla plugin k interactive
lla plugin n search "react"Alias Benefits
- Less Typing:
jinstead ofjwt - Faster Workflow: Shorter commands for frequent tasks
- Works Everywhere: Shortcuts, manual commands, all syntax styles
- Personal Preference: Customize to your naming conventions
Recommended Aliases
Common short aliases:
[plugin_aliases]
# Development
j = "jwt" # JWT operations
n = "npm" # Package search
cc = "code_complexity" # Code analysis
sn = "code_snippet_extractor" # Snippets
# System
k = "kill_process" # Process management
fd = "flush_dns" # DNS flush
# Search & Web
gs = "google_search" # Web search
yt = "youtube" # YouTube search
gm = "google_meet" # Meetings
# File Operations
fm = "file_mover" # Move files
fc = "file_copier" # Copy files
fr = "file_remover" # Remove files
fo = "file_organizer" # Organize files
ft = "file_tagger" # Tag filesAliases in Shortcuts
Aliases automatically work in shortcuts:
# Create shortcut using alias
lla shortcut add decode-jwt j decode -d "Decode JWT"
# Or use full name (equivalent)
lla shortcut add decode-jwt jwt decode -d "Decode JWT"Both create the same shortcut. The alias is resolved when you run the command.
Performance Considerations
Defaults for large directory operations:
- Tree view: 20,000 entries maximum
- Recursive listing: 20,000 entries maximum
- Directory sizes: Optional for performance
- Fuzzy search: Smart pattern exclusions
Adjust these based on your system.