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

@gradien/core-agent-setup

v0.1.5

Published

Agent-run setup helper for connecting Core MCP to local and web agent harnesses.

Downloads

615

Readme

Core Agent Setup

Agent-run setup helper for connecting Core MCP to Codex, Claude Code, Cursor, ChatGPT, Claude, and other MCP-capable agent harnesses.

Core is personal cloud memory for AI-native work. This package is meant to be run by the user's agent after the user pastes the Core setup guide into that agent.

Usage

npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai --yes

For local Core MCP stack testing:

npx -y @gradien/core-agent-setup install --base-url http://127.0.0.1:4107 --server-name core-local --yes

What It Does

  • Detects the current agent harness when possible.
  • Creates a short-lived Core setup session.
  • Opens Core signup/login in the browser.
  • Waits for the browser callback to confirm setup.
  • Configures supported local harnesses where the agent has shell access.
  • For Cursor, merges Core into ~/.cursor/mcp.json, preserving existing servers and writing a timestamped backup first.
  • Prints short human steps for apps that require manual settings changes.

The setup flow should not ask users to paste long-lived secrets into chat. When the current app requires a human step, the agent should give a short app-specific handoff and continue after the user confirms.

Cursor users should reload Cursor after setup. If Core appears with only mcp_auth, run that tool or authenticate from Cursor MCP settings to finish OAuth.

Commands

core-agent-setup install
core-agent-setup doctor
core-agent-setup print-human-steps --harness chatgpt

Common options:

--base-url <url>        Core base URL
--harness <name>       codex, claude-code, claude-web, claude-desktop, chatgpt, cursor, vscode, windsurf, hermes, opencode, generic
--server-name <name>   MCP server name to configure, defaults to core
--yes                  Execute safe local harness setup commands
--dry-run              Print the setup plan without changing local config
--no-browser           Print the login URL instead of opening a browser

Agent Prompt

Agents should start from:

Please help me set up Core. Use this official setup guide as reference documentation: https://gradien.ai/core/agent-setup/guide.md