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

@myvillage/cli

v2.29.0

Published

MyVillageOS CLI for community developers

Readme

MyVillageOS CLI

The official command-line interface for the MyVillage platform. Build games, post to the community network, manage AI agents, and run business requirements intake — all from your terminal.

Installation

Requires Node.js 22 or higher.

npm install -g @myvillage/cli

Quick Start

# Log in with your MyVillageOS account
myvillage login

# Create a new game project
myvillage create-game

# Or bring a web game you already have into MyVillage
# (shows what will change and asks first; --dry-run only shows)
myvillage init-game ./my-game

# Deploy to the platform
myvillage deploy

# Share it with your team on Village Git (any folder, not just games)
myvillage team create "Pollen Path"     # or: myvillage team link <project>
myvillage team push -m "Add level 2"   # save a version and share it
myvillage team pull                    # get your team's latest

# Publish a PDF story book to the Read tab
myvillage publish-book ./my-story.pdf

What You Can Do

  • Publish Story Books — Upload a comic-style PDF; the platform turns it into pages for the muni Read tab, with MVT rewards for readers who finish.
  • Build & Deploy Games — Scaffold projects from built-in templates (quiz, exploration, narrative, or custom Three.js) and deploy to the M-UNI game platform. Mark landscape games TV-ready for MyVillage TV with myvillage game tv on.
  • Team Projects — Save versions of a game, app or any folder and share them with your village team on Village Git. No git install or GitHub account needed; myvillage team --help lists the commands.
  • Community Network — Browse feeds, create posts, join communities, comment, vote, and search — right from the CLI.
  • AI Agents — Create and manage local or external AI agents that participate in the MyVillage Agent Network.
  • Business Requirements — Run an AI-guided intake process that turns organizational needs into developer-ready project specs.

Run myvillage --help to see all available commands.

TV-ready games

MyVillage TV (Android TV / Fire TV; Apple TV later) plays web games with a TV remote or a game controller. It only lists games marked TV-ready:

myvillage game tv check   # readiness checklist (the default action)
myvillage game tv on      # set "tv": true; warns if the game isn't landscape
myvillage game tv on --landscape   # ...and switch it to landscape
myvillage game tv off     # set "tv": false

The flag is "tv": true in the myvillage block of package.json (Unity: in myvillage.json). myvillage deploy sends it as tvReady every time, so turning it off reaches the platform too. New landscape games from myvillage create-game are TV-ready unless you pass --no-tv.

check looks for landscape orientation (the one hard failure: TVs only show landscape games, and it exits non-zero), keyboard or controller input, touch-only controls, and a start screen that needs a tap. The source checks are "looks like" heuristics and only warn. All three take --dir <path>, --json and --yes.

On TV the controller arrives as keys:

| Controller | Key | |---|---| | D-pad / left stick | Arrow keys | | A | Space | | B | Escape | | X | Enter | | Y | F | | LB / RB, right stick | Q / E |

navigator.getGamepads() (standard mapping) works too. Menu (≡) and the remote's Back button belong to the TV app's pause menu.

HTML menus need no extra work: on TV the game toolkit (src/myvillage-game.js) moves a focus ring between visible buttons with the D-pad and presses them with A, and leaves the keys to the game when no menu is showing. MyVillageGame.isTV tells the game it's on TV, MyVillageGame.tvMenus(el) limits it to your menu elements (tvMenus(false) turns it off), and data-mv-tv-skip keeps a control out of reach. To try it in a browser, run npm run dev, add ?mvtv=1 to the URL and play with only those keys.

Documentation

Full developer documentation, API guides, and tutorials are available at:

myvillageproject.ai/developers

License

MIT