Shellpa's adapter design covers zsh, fish, and Bash; the submitted release supports only target and shell combinations marked passed in the linked support matrix. It filters the current syntax slot, ranks valid candidates using local preference signals, and keeps the full verified result set available through pagination. Finder searches meaning as well as spelling, so stopped containers can find --all through its reviewed description without requiring the user to remember the option name.
The normal interaction is local. Parsing, strict filtering, ranking, pagination, Finder, and Local Explain do not call GPT. A machine-specific value is offered only when a bounded local generator passes its capability and sandbox checks; unsupported discovery is omitted. Preference signals can reorder candidates that are already valid for the current slot, but cannot introduce an invalid command or option. Shellpa stores stable command-node aggregates instead of raw history, paths, filenames, resource names, or argument values.
Ctrl+/ opens deterministic Local Explain from the installed verified spec. Alt+/ is the explicit Deep Explain action. It sends an allowlisted structure of verified node IDs, relationships, reviewed descriptions, and typed redacted argument roles to GPT-5.6 through the OpenAI Responses API. Shellpa rejects a response that violates the strict schema or refers to an unknown node. A failed or cancelled provider request leaves the editable shell and Local Explain available.
Shellpa preserves normal Enter behavior and never executes a suggestion on the user's behalf. It includes Korean and English command content, immutable revision-bound pages, stale-result rejection, data controls, and signature-checked update and rollback infrastructure. The release page and support matrix identify the exact native targets and shell versions that passed instead of claiming universal Linux support.
I used one primary Codex implementation thread for product architecture, Rust implementation, tests, and integration. I made the product and privacy decisions: no GPT call while typing, normal Enter behavior, Finder insertion without execution, personalization limited to ranking, and a narrow Deep Explain privacy boundary. Bounded specialist reviews covered packaging, conformance, chaos, and security, with their roles recorded in the repository.
Log in or sign up for Devpost to join the conversation.