Gemini CLI
Install the Vulnetix security plugin for Gemini CLI.
Quick Install
npx skills add Vulnetix/pix-ai-coding-assistant
This installs the Vulnetix security skills into your project’s .gemini/skills directory.
Via GitHub CLI (Preview)
GitHub CLI v2.90.0+ can install individual skills with version pinning via gh skill:
gh skill install Vulnetix/pix-ai-coding-assistant dashboard --agent gemini-cli
gh skill install Vulnetix/pix-ai-coding-assistant exploits --agent gemini-cli
gh skill install Vulnetix/pix-ai-coding-assistant fix --agent gemini-cli
gh skill install Vulnetix/pix-ai-coding-assistant vuln --agent gemini-cli
gh skill install Vulnetix/pix-ai-coding-assistant exploits-search --agent gemini-cli
gh skill install Vulnetix/pix-ai-coding-assistant package-search --agent gemini-cli
gh skill install Vulnetix/pix-ai-coding-assistant remediation --agent gemini-cli
Note: gh skill installs skills only. For the full plugin (hooks, commands, and bulk-triage agent), use npx skills add above. Keep skills current with gh skill update.
Prerequisites
Before running the install command:
- Node.js — Required to run
npx. Install from nodejs.org if not already available. - Vulnetix CLI — Install and authenticate following the prerequisites guide.
- jq — Required by plugin hooks for JSON processing. See prerequisites for install instructions.
What Gets Installed
The plugin registers the following into .gemini/skills:
| Component | Count | Details |
|---|---|---|
| Hooks | 6 | Pre-commit scan, manifest edit gate, post-install scan, session dashboard, stop reminder, vuln context inject |
| Skills | 6 | package-search, exploits, fix, vuln, exploits-search, remediation |
| Commands | 4 | vdb-vuln, vdb-vulns, vdb-exploits-search, vdb-remediation |
| Agents | 1 | bulk-triage — parallel vulnerability triage and prioritization |
Native Hooks
Gemini CLI supports hooks natively. The plugin ships hooks.gemini.json pre-configured for Gemini’s hook system. After install, hooks are registered automatically — no manual configuration needed.
The following events are wired up:
| Hook | Event | Matcher | Timeout |
|---|---|---|---|
| Pre-Commit Scan | BeforeTool | Bash | 30s |
| Manifest Edit Gate | BeforeTool | Edit|Write | 30s |
| Post-Install Scan | AfterTool | Bash | 120s |
| Session Summary | BeforeAgent | – | 10s |
| Stop Reminder | AfterAgent | – | 10s |
| Context Inject | BeforePrompt | – | 15s |
See Hooks documentation for details on each hook.
Verify Installation
Run the dashboard skill to confirm everything is working:
/vulnetix:dashboard
You should see a vulnerability summary table for your project’s dependencies. If you get an authentication error, re-run vulnetix auth login.
Upgrade
Re-run the install command to pull the latest version:
npx skills add Vulnetix/pix-ai-coding-assistant
This overwrites existing files with the latest version. Your .vulnetix/memory.yaml and cached data are not affected.
Uninstall
Remove the plugin skills:
rm -rf .gemini/skills
To also remove cached vulnerability data and memory:
rm -rf .vulnetix/