@wiz-sh/types contains .d.wiz declaration libraries for shells and command-line tools. They give the compiler, linter, language server, and IntelliSense precise knowledge of command options, operands, result channels, environment variables, and documentation without executing a tool.
The library covers Bash, Zsh, POSIX sh, Wiz itself, GNU/core utilities, disk and network tools, Git and GitHub CLI, SSH, GPG, OpenSSL, databases, language toolchains, package managers, Nix, and common AI coding agents. Broad packs are split into importable paths so projects load only what they use.
wiz install @types/commonUse Wiz’s Bash-like type import syntax rather than executing declaration files as shell code:
source -T git from "@types/common/git"
source -T { grep, rg } from "@types/common/search"
source -T * from "@types/wiz"
The standard shell and Wiz declarations are available by default. Explicit imports make optional tool surfaces visible to the project graph and keep completion results relevant.
Declarations should model real subcommands, options, required and optional operands, repeated arguments, status/stdout behavior, and useful documentation. any is reserved for boundaries whose shape genuinely cannot be expressed. A declaration such as ...arguments: any[] is not considered a complete CLI definition.
bun install
bun run check
bun run buildTests parse every declaration, reject accidental executable content, verify package-path resolution, and enforce catalog integrity. Add focused declarations to an existing balanced pack instead of creating empty directories or one-file folder hierarchies.
Licensed under MIT.