rea
Reverse engineer anything with agents, from app behavior down to native binaries.
Stops AI agents installing npm packages that don't exist, typosquats, or risky install scripts.
Skills that teach the AI this kind of work; they work alongside this one
Reverse engineer anything with agents, from app behavior down to native binaries.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 7/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 19/100 |
Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install ghostimport. Follow https://mcp.popnx.com/i/fguerreir0-ghostimport.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 18, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server ghostimport for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "ghostimport": { "command": "npx", "args": [ "-y", "ghostimport", "mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the ghostimport tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"ghostimport": {
"command": "npx",
"args": [
"-y",
"ghostimport",
"mcp"
]
}
}
}Use ghostimport and tell me what you can do for me, then show me one thing✓ If Claude says it is using ghostimport or shows a ghostimport tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect ghostimport yet
ghostimport runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect ghostimport
B · Others in Developer tools that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server ghostimport for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user ghostimport -- npx -y ghostimport mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the ghostimport tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user ghostimport -- npx -y ghostimport mcpYou should see ghostimport listed as connected
Use ghostimport and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using ghostimport or shows a ghostimport tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server ghostimport for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "ghostimport": { "command": "npx", "args": [ "-y", "ghostimport", "mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the ghostimport tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use ghostimport and tell me what you can do for me, then show me one thing✓ If Cursor says it is using ghostimport or shows a ghostimport tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server ghostimport for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "ghostimport": { "type": "stdio", "command": "npx", "args": [ "-y", "ghostimport", "mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the ghostimport tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use ghostimport and tell me what you can do for me, then show me one thing✓ If VS Code says it is using ghostimport or shows a ghostimport tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user ghostimport -- npx -y ghostimport mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"ghostimport": {
"command": "npx",
"args": [
"-y",
"ghostimport",
"mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"ghostimport": {
"command": "npx",
"args": [
"-y",
"ghostimport",
"mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"ghostimport": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ghostimport",
"mcp"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: ghostimportBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account FGuerreir0, which owns the repo
Code last changed yesterday
No licence file found in the repo
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked yet
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/fguerreir0-ghostimport)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed yesterday, and the latest version (0.7.4) reached the registry yesterday.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP servers
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| This one ghostimport | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | Yes | No | No |
| Basic checks | 2/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| License | – | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
ghostimport
Stops your AI coding agent from installing npm packages that don't exist.
How the attack works →
Your agent invents a package name. It doesn't exist on npm *yet*. Someone is watching for exactly that, and the moment they register it, npm install runs their postinstall script on your machine.
This is slopsquatting. Most dependency scanners inspect packages after they are installed; ghostimport checks names before they are — against the live registry, at the moment your agent writes or installs them.
$ ghostimport
Scanned 142 files · 38 packages
✗ react-server-fetch does not exist on npm ↳ src/data/loader.ts ↳ unregistered — anyone could claim this name with a malicious postinstall
✗ axois high risk ↳ src/api/client.ts ↳ 1-2 chars from 'axios' — likely a typo ↳ has postinstall script — runs code on npm install created 2019-08-29 · 1245/week · 1 version
2 problems found.
One command installs the blocking hooks and the MCP server together:
/plugin install ghostimport --marketplace FGuerreir0/ghostimport
On Claude Code older than 2.1.275, add the marketplace first: /plugin marketplace add FGuerreir0/ghostimport, then /plugin install ghostimport@ghostimport.
The plugin runs the CLI bundled in the npm package — no global install, no npx on every edit. If you already wired the hooks into .claude/settings.json by hand, remove them when you install the plugin, or every command is checked twice. Node.js 22+. Zero runtime dependencies: the published package uses only Node built-ins.
For the CLI, CI, or another agent:
npm install -g ghostimport # or: npx ghostimport
This is the part that matters. A CI check tells you about a bad package *after* it's in your repo; these stop it at the moment it's written.
The plugin installs these. To set them up by hand instead, install ghostimport globally (npm install -g ghostimport, since the hook runs ghostimport directly) and add to .claude/settings.json:
{
"hooks": { "PreToolUse": [ { "matcher": "Bash|PowerShell", "hooks": [{ "type": "command", "command": "ghostimport hook" }] } ], "PostToolUse": [ { "matcher": "Edit|Write|MultiEdit", "hooks": [{ "type": "command", "command": "ghostimport hook" }] } ] } }
npx, npm exec, npm create, pnpm dlx, yarn dlx, bunx), and denies the tool call if it would fetch a package that doesn't exist, is a typosquat, or runs an install script with no track record behind it. Established packages that ship one (esbuild, puppeteer) go through. This is the one that stops a real attack.package.json, and tells it to fix them.npx deserves the attention: it runs the package's code immediately, no postinstall needed, and agents copy npx commands out of READMEs and skill files without checking them. An npx of a bin your project already has installed (npx tsc) runs the local copy and isn't checked.
The agent sees why it was stopped:
ghostimport blocked this: the install command below would fetch packages that
are unsafe or do not exist.
• 'axois' exists but is high risk: name is 1-2 chars from 'axios'; single version published.
Do not retry this command as written.
It fails open. Registry unreachable, malformed payload, or a check exceeding its 20-second budget → exits 0 and stays out of the way. A security tool that wedges your agent when you're offline gets uninstalled by Friday.
Lets the model verify a name *before* it writes the import. Hooks are mandatory; MCP tools are offered — use both.
claude mcp add ghostimport -- npx -y ghostimport mcp # included in the plugin
Cursor, Windsurf, and other MCP clients
Add to .cursor/mcp.json or your client's config:
{
"mcpServers": { "ghostimport": { "command": "npx", "args": ["-y", "ghostimport", "mcp"] } } }
| Tool | What it does |
|---|---|
check_packages | Verify package names exist on npm. deep adds risk heuristics. |
check_install_command | Vet a full npm/pnpm/yarn/bun command — installs, and npx/dlx/create runs. |
scan_project | Audit a whole directory. |
ghostimport # scan the current directory
ghostimport ./src # scan a folder ghostimport --json # machine-readable ghostimport --watch # re-scan on change
Exits 1 if any imported package doesn't exist, so it works as a CI gate as-is.
All options
| Flag | Effect |
|---|---|
--quiet, -q | Only show problems |
--json | Output results as JSON |
--watch, -w | Re-scan on file changes |
--badge | Print a README badge after scanning |
--fast | Skip the deep supply-chain check on undeclared packages |
--no-undeclared | Hide "imported but not in package.json" warnings |
--no-cache | Bypass the 24h registry cache |
--version, -v · --help, -h |
Optional .ghostimportrc.json in your project root:
{ "ignore": ["@company/*", "internal-lib"], "includeUndeclared": true }
CI: GitHub Actions and pre-commit
- uses: FGuerreir0/ghostimport@v0.6.1
with: path: '.'
Or just run: npx ghostimport --quiet.
For pre-commit, in .pre-commit-config.yaml:
repos:
import { verifyPackages, scan } from 'ghostimport'
await verifyPackages(['axios', 'axois'], { deep: true }) // [ { pkg: 'axios', status: 'ok', typosquatOf: null }, // { pkg: 'axois', status: 'suspicious', risk: 'high', typosquatOf: 'axios', ... } ]
const { missing, undeclared, risks } = await scan('./src')
status is 'ok' | 'missing' | 'suspicious' | 'unknown'. 'unknown' means the registry was unreachable — never treat it as a failure.
Full API and TypeScript types
| Export | Purpose | |
|---|---|---|
scan(dir, opts?) | Scan a directory. Returns ScanResult. | |
verifyPackages(names, opts?) | Check a list of names. Returns PackageVerdict[]. | |
checkNpm(name) | Does this one package exist? | |
checkPackageRisk(name) | Full supply-chain check for one package. | |
detectTyposquat(name) | Returns the popular package it's 1-2 chars from, or null. | |
extractImports(code) | Package names from a source string. | |
extractInstallTargets(cmd) | Packages a shell command would install. | |
extractCommandTargets(cmd, { cwd?, dialect? }) | Packages a command would install or run (npx, dlx, create), with `action: 'install' | 'exec'. dialect: 'powershell'` reads PowerShell quoting. |
interface ScanResult {
scanned: number packages: number missing: { pkg: string; files: string[]; claimable: boolean | null }[] // don't exist on npm; claimable is false // inside a scope someone already owns undeclared: { pkg: string; files: string[] }[] // exist, but not in package.json risks: RiskEntry[] // supply-chain findings errors: { pkg: string; error: string; files: string[] }[] cacheHits: number }
type RiskEntry = | { pkg: string; files: string[]; type: 'unregistered'; typosquatOf: string | null } | { pkg: string; files: string[]; type: 'suspicious' risk: 'medium' | 'high'; flags: string[]; installScripts: string[] typosquatOf: string | null; maintainers: number created: string; downloads: number | null; versions: number }
Types are shipped with the package: ScanResult, ScanOptions, MissingRef, RiskEntry, PackageVerdict, VerdictStatus, PackageRiskResult, NpmCheckResult, Config.
What gets scanned, and what raises a risk
Detects: import, require(), dynamic import(), export … from, scoped packages, subpath imports (pkg/utils → pkg), and blocks in .vue, .svelte and .astro (markup is ignored, so a package name in template text is never flagged). Also every registry dependency declared in any package.json, whether or not anything imports it — workspace:, file:, link:, git and URL specs are skipped, and npm: aliases are followed to the real name.
Extensions: .js .jsx .ts .tsx .mjs .cjs .vue .svelte .astro
Ignores: Node built-ins, relative imports, path aliases (@/, ~/, $lib/, tsconfig paths), URL/protocol imports, virtual modules, workspace packages, and node_modules/ dist/ build/ .git/.
Risk signals:
| Signal | Weight | Why |
|---|---|---|
| Name 1-2 chars from a popular package, < 10k weekly downloads | critical | Classic typosquat. Established near names (preact, redis, cypress) aren't flagged |
postinstall / preinstall / install script | amplifier | Runs arbitrary code on npm install. Critical alongside any medium signal; normal on its own (esbuild, puppeteer) |
| Created < 30 days ago | medium | No track record |
| < 50 weekly downloads | medium | Near-zero adoption |
| Single version published | medium | Abandoned or one-shot |
| Single maintainer | amplifier | Only counts alongside another signal |
high if any critical signal fires, or 2+ medium ones (a single maintainer counts as a second). Only medium and high are reported.
A name that doesn't exist on npm is reported as squattable unless it sits in a scope someone already owns — only a scope's owner can publish under it, so @babel/made-up is a broken import but not a squatting target. That check costs at most one request per scope, so --fast doesn't disable it.
Development setup, the source layout, and how the site in docs/ is built and deployed all live in CONTRIBUTING.md.
ghostimport is free, MIT licensed and has no runtime dependencies — and it stays that way. If it caught something for you, you can buy me a coffee.
MIT