Omahub
← All plugins
Y

npichy

by yamz8

Look up healthcare providers in the NPI registry from the Omarchy bar

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
31035c3
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
31035c3
Reviewed
1 month ago

The plugin is a straightforward bar widget that queries the public NPPES NPI registry via curl, parses the JSON response, and copies NPIs to the clipboard. The code is transparent, uses no obfuscation, performs no destructive or persistent actions, and only communicates with the intended CMS endpoint. The deterministic scan found no issues, and the manual review agrees.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/yamz8/npichy --enable
Productivity #bar #quickshell

npichy

npichy is a native Omarchy bar plugin for looking up healthcare providers in NPPES, the U.S. registry behind every National Provider Identifier. Type a name, an organization, or a ten-digit NPI, and the matching records come back live.

Each result shows the NPI, the provider's primary taxonomy and licence number, the practice location and phone, and whether the enumeration is still active. Pressing Enter copies the NPI to the clipboard and leaves the panel open.

Individuals and organizations are separate searches

NPPES splits its registry in two: NPI-1 is an individual clinician, matched through first_name / last_name, and NPI-2 is a practice or facility, matched through organization_name. The API ANDs whatever criteria it is given, so a request carrying both a surname and an organization name matches nothing. The widget therefore searches one or the other, switched by the Record type control, rather than pretending a single query covers both.

A ten-digit NPI bypasses this entirely — a number identifies exactly one record, so the type and state filters are dropped from that request.

Names

You type Searched as
aalbers surname aalbers*
john aalbers first john*, surname aalbers*
Aalbers, John surname Aalbers*, first John* — the form directories print
1942262431 NPI number, filters ignored

Terms of two characters or more get a trailing wildcard, so a partial name still finds the provider. NPPES rejects a wildcard with fewer than two leading characters, so a single letter is sent unstarred.

Former names

NPPES matches former and other names as well as current ones. Searching smith in VT returns a record named Audette — because Smith is her former name. That is the registry working correctly, so rather than looking like a mismatch, the matched name is shown on the result as Former Name: Judy Ann Smith.

Keys

Key Action
Enter Copy the selected NPI to the clipboard (runs the search first if the query changed)
Ctrl+Enter Open the selected record in the configured browser
↑ ↓ Move the selection
Esc Close the panel

Left-clicking a result copies it; right-clicking opens it. Right-clicking the bar icon opens the NPI registry search page.

Scripting

The widget answers on its own IPC target, so a lookup can come from a keybinding or a script:

omarchy-shell yamz8.npichy lookup "aalbers"                      # opens the panel and searches
omarchy-shell yamz8.npichy lookupIn "mayo clinic" organization   # ... as an organization
omarchy-shell yamz8.npichy copy                   # copies the selected NPI, echoes it
omarchy-shell yamz8.npichy toggle                 # open / close

lookupIn takes the record type (individual or organization) as a second argument; Quickshell requires every declared IPC parameter, so the one-argument form is its own method rather than an optional argument. Both return ok, or empty query when handed nothing. copy returns the NPI it put on the clipboard, or no selection.

Omarchy integration

The widget uses Omarchy's native Panel, BarIconButton, KeyboardPanel, PanelHero, ButtonGroup, and theme tokens. Its account-search mark is a monochrome Nerd Font glyph, so it follows the active bar foreground color and font instead of falling back to a colored emoji.

Runtime dependencies are curl, wl-copy, and network access to npiregistry.cms.hhs.gov. No API key is needed.

Privacy

NPPES is a public registry of providers, not patients. The plugin writes no cache, history, or analytics, and clears the query and results whenever the panel closes. Queries are still sent to CMS, so do not enter patient names, record numbers, or other personal identifiers.

Settings

Setting Values Default
Record type searched first individual, organization individual
Default state filter two letters, or blank blank
Results shown 5–12 8

Install

omarchy plugin add https://github.com/yamz8/npichy.git --enable

omarchy plugin add clones the repository, validates the manifest, and installs it as yamz8.npichy. Update later with omarchy plugin update yamz8.npichy.

Install from a local checkout

cp -R ./npichy ~/.config/omarchy/plugins/yamz8.npichy
omarchy plugin validate ~/.config/omarchy/plugins/yamz8.npichy
omarchy plugin enable yamz8.npichy

Plugin files hot reload. If the widget does not appear immediately, run:

omarchy-shell shell rescanPlugins

Remove

omarchy plugin disable yamz8.npichy
omarchy plugin remove yamz8.npichy

Removing the plugin takes the widget out of the bar and deletes ~/.config/omarchy/plugins/yamz8.npichy. The plugin writes nothing outside that folder and never modifies your Omarchy configuration, so nothing is left behind.

Use

  • Left-click the account-search icon to open the provider finder.
  • Right-click it to open the NPI registry search page.
  • Press Enter to search, then Enter again to copy the selected NPI.
  • Press Ctrl+Enter to open the record in the browser.
  • Press Up/Down to choose a result, Esc to close, or Tab to switch bar panels.

The bar editor exposes every setting below. For example:

omarchy bar set yamz8.npichy defaultType organization
omarchy bar set yamz8.npichy defaultState CA
omarchy bar set yamz8.npichy resultLimit 10

Validate

omarchy plugin validate .
node --test tests/npi.test.mjs
/usr/lib/qt6/bin/qmlformat Npichy.qml >/dev/null

Data source

NPPES is a public registry of healthcare providers, published by the U.S. Centers for Medicare & Medicaid Services. No API key is required.

License

MIT