npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@bitsness/grapuco-cli

v1.12.3

Published

Grapuco CLI — Parse your code locally, sync architecture to cloud. Zero source code upload.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

duckmink.bitsnessduckmink.bitsness

Keywords

clicode-analysisastarchitecturegraph

Readme

Grapuco CLI

Transform your source code into a Knowledge Graph for AI Coding Agents.

Grapuco CLI parses your codebase locally, extracts architecture metadata (functions, classes, relationships), and syncs it to the Grapuco cloud — your source code never leaves your machine.

Getting Started

# Install globally
npm install -g @bitsness/grapuco-cli

# Login with your API key (get one at https://grapuco.com/dashboard)
grapuco login --api-key YOUR_API_KEY

# Initialize in your project
cd ~/projects/my-app
grapuco init

# Parse & push your codebase
grapuco ingest

# Auto-configure MCP for your editors
grapuco setup

What Does It Do?

  1. Parse — Scans your code locally using AST analysis
  2. Push — Syncs only architecture metadata (zero source code upload)
  3. Connect — Auto-configures MCP for AI coding editors so they understand your codebase

Commands

Auth

| Command | Description | |---------|-------------| | grapuco login | Authenticate with your Grapuco API key |

| Flag | Description | |------|-------------| | --api-key <key> | API key (or enter interactively) | | --server <url> | Server URL (default: https://api.grapuco.com) |

Project Setup

| Command | Description | |---------|-------------| | grapuco init | Initialize Grapuco in the current project directory |

| Flag | Description | |------|-------------| | --name <name> | Repository name (defaults to folder name) | | --link <repoId> | Link to existing repository instead of creating new | | --server <url> | Override Grapuco Enterprise server URL |

Core Workflow

| Command | Description | |---------|-------------| | grapuco ingest | Parse all source files locally and push to cloud (embeddings + flows ON by default) | | grapuco push | Delta sync — push only changed files since last push | | grapuco watch | Watch for file changes and auto-push |

grapuco ingest flags:

| Flag | Description | |------|-------------| | --skip-embeddings | Skip AI embeddings (saves credits) | | --skip-flows | Skip data flow analysis (saves credits) | | --dry-run | Parse only, do not push to server |

grapuco push flags:

| Flag | Description | |------|-------------| | --force | Force full re-push (ignore cache) | | --skip-embeddings | Skip AI embeddings for this push | | --enrich-flows | Trigger AI data flow enrichment after delta sync |

grapuco watch flags:

| Flag | Description | |------|-------------| | --debounce <ms> | Debounce interval in ms (default: 2000) |

Info

| Command | Description | |---------|-------------| | grapuco status | Show sync status of current project | | grapuco inspect | Preview what data will be sent to server |

| Flag | Description | |------|-------------| | --json | Output as JSON (inspect only) |

Editor Setup

| Command | Description | |---------|-------------| | grapuco setup | Auto-configure MCP for all of your AI editors |

| Flag | Description | |------|-------------| | --editor <name> | Target a specific editor | | --api-key <key> | API key (defaults to saved credentials) | | --endpoint <url> | Server endpoint URL | | --print | Preview config without writing | | --remove | Remove Grapuco config from all editors | | --scope <scope> | Config scope: global or project (default: global) |

Supported editors:

| Editor | Config | |--------|--------| | Claude Code | claude mcp add CLI | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | VS Code Copilot | <user config>/Code/User/mcp.json | | Codex | ~/.codex/config.toml | | Antigravity | ~/.gemini/antigravity/mcp_config.json |

Enterprise & Custom Servers

# Environment variable
export GRAPUCO_SERVER="https://grapuco.internal.company.com"

# Or via login
grapuco login --api-key YOUR_KEY --server https://grapuco.internal.company.com

Links

License

MIT