hilbish

Document Hilbish shell internals including completion, Lua API, and startup.

1.4k|36|Updated Mar 17, 2020
One-click install
npx skills add https://github.com/carapace-sh/carapace --skill hilbish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hilbish
Source: https://github.com/carapace-sh/carapace/tree/main/skills/hilbish
Command: npx skills add https://github.com/carapace-sh/carapace --skill hilbish

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a comprehensive reference to Hilbish's internal systems, including the completion engine, Lua API, runner model, line editing, and startup bootstrap.

Core Features & Use Cases

  • Access detailed documentation for Hilbish components like hilbish.completions, the line editor, the language and API, the execution model, and the startup sequence.
  • Discover cross-project references and how per-command completions are wired into the shell.
  • Quickly locate references for integration tasks (e.g., carapace integration, per-command completions, and aliasing hooks) and troubleshooting.

Quick Start

Read the Hilbish internals and jump to the topic you need by opening the relevant references.

Frequently Asked Questions about hilbish

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the Hilbish completion system work for per-command hooks?

The Hilbish completion system wires per-command completions through a Lua API, allowing developers to hook into the shell's line editor and register custom completion logic for specific commands. References detail how the completion engine integrates with line editing.

What is the Hilbish runner model and how does it execute commands?

The Hilbish runner model defines the execution flow for commands within the shell. This reference covers the architecture of how the Lua API interacts with the runner model to process and execute user input during a session.

How do I integrate carapace completions into a Hilbish shell?

To integrate carapace completions into Hilbish, you use the Lua API to bridge the external completion generator with the shell's internal completion engine. The reference provides cross-project integration points and aliasing hooks needed for setup.

Does Hilbish use Lua for its core API and line editing?

Yes, Hilbish uses Lua as its core scripting language for the API, exposing internals for line editing and completions. Developers interact with the shell's readline features and execution model directly through Lua functions.

What is covered in the Hilbish startup bootstrap sequence?

The Hilbish startup bootstrap sequence covers the initialization of the shell, including how the Lua environment is loaded and how the runner model is configured before user interaction. The reference maps the exact startup steps.

Where can I find references for troubleshooting Hilbish internals?

You can find references for troubleshooting Hilbish internals by navigating the included Markdown files, which guide you to exact topics like completion, line editing, language, execution, and startup. The frontmatter supports targeted exploration.