carapace-sh Bash BLE (ble.sh) In-Depth Reference
Comprehensive reference for ble.sh (Bash Line Editor) internals, with emphasis on the completion system and how external tools hook into it.
Sub-Resources
Load the reference that matches your task. When in doubt, load multiple references.
| Keywords | Reference |
|---|---|
| ble/complete, cand/yield, completion source, completion action, progcomp, COMPREPLY, compopt, menu style, menu-filter, auto-complete, sabbrev, dabbrev, complete_menu_style, ble/no-default, ble/filter-by-prefix, ble/syntax-raw, ble/no-mark-directories, ble/prog-trim, ble/default, COMPV, COMP1, COMP2, COMPS, comp_type, cand_pack, cand_cand, cand_word, quote-insert, action:plain, action:word, action:file, action:command, action:progcomp, action:mandb, complete_load, complete_limit, complete_ambiguous, complete_polling_cycle, complete_timeout_auto, complete_auto_complete, complete_auto_delay, complete_auto_menu, complete_menu_complete, complete_menu_filter, complete_menu_maxlines, menu_align_min, menu_align_max, menu_prefix, menu_desc_multicolumn_width, menu_complete_selected, menu_filter_fixed, menu_filter_input, menu_complete_match | references/completion.md |
| syntax highlighting, syntax parser, ble-face, gspec, face, syntax_default, syntax_command, syntax_quoted, syntax_quotation, syntax_escape, syntax_varname, syntax_comment, syntax_error, syntax_delimiter, syntax_param_expansion, syntax_history_expansion, syntax_function_name, syntax_glob, syntax_brace, syntax_tilde, syntax_document, command_builtin, command_alias, command_function, command_file, command_keyword, filename_directory, filename_executable, filename_link, varname_unset, varname_export, varname_array, _ble_syntax_tree, _ble_syntax_attr, _ble_syntax_stat, _ble_syntax_nest, highlight_syntax, highlight_filename, highlight_variable, color_scheme, LS_COLORS | references/syntax-highlighting.md |
| editor, widget, keymap, ble-bind, emacs, vi_imap, vi_nmap, vi_omap, vi_xmap, key binding, _ble_edit_str, _ble_edit_ind, _ble_edit_mark, kill ring, yank, undo, overwrite mode, numeric argument, keymap stack, decode, input processing, C-x, M-x, S-x, default, defchar, before_widget, after_widget, canvas, terminal rendering, DRAW_BUFF, ble/canvas, ble/textarea, sigwinch, tab_width, emoji_width, grapheme_cluster | references/editor.md |
| installation, startup, blerc, bleopt, blehook, ble-import, XDG, _ble_base, _ble_base_run, _ble_base_cache, _ble_base_state, --attach, --rcfile, ble-attach, PROMPT_COMMAND, complete_load hook, keymap_emacs hook, keymap_vi hook, PRECMD, PREEXEC, POSTEXEC, import_path, config/readline, integration/fzf | references/startup-config.md |
Quick Guide
- How do I write a BLE completion function? → references/completion.md
- How does ble/complete/cand/yield work? → references/completion.md
- How does BLE integrate with bash programmable completion? → references/completion.md
- What are the BLE menu styles? → references/completion.md
- How does menu-filter work? → references/completion.md
- How does auto-complete work? → references/completion.md
- What are sabbrev and dabbrev? → references/completion.md
- What BLE compopt extensions exist? → references/completion.md
- How does syntax highlighting work? → references/syntax-highlighting.md
- How do I configure faces/colors? → references/syntax-highlighting.md
- How do I bind keys? → references/editor.md
- What widgets are available? → references/editor.md
- How does the editor replace Readline? → references/editor.md
- How do I install and configure ble.sh? → references/startup-config.md
- What is the blerc file? → references/startup-config.md
- How do bleopt/blehook/ble-import work? → references/startup-config.md
Cross-Project References
- For carapace-specific BLE integration (snippet, value format, per-candidate suffix), see the carapace-dev skill →
references/shell-bash-ble.md. - For standard bash completion (COMP_* variables, complete builtin, compgen, compopt, Readline), see the bash skill.