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

stratumn-cli

v0.30.0

Published

CLI tools for Stratumn

Readme

Stratumn CLI

Installation

$ npm install -g stratumn-cli

You might have to sudo:

$ sudo npm install -g stratumn-cli

Usage

  Usage: stratumn [command] [options]


  Commands:

    signup                                  create an account
    login                                   login to your account
    logout                                  delete authentication data
    whoami                                  display logged in user
    passwd                                  change your password
    list                                    list applications
    ls                                      list applications
    show <app-name>                         show application details
    view <app-name>                         show application details
    info <app-name>                         show application details
    metrics <app-name>                      show application metrics
    stats <app-name>                        show application metrics
    operations [app-name]                   show application operations
    ops [app-name]                          show application operations
    logs [app-name]                         show application operations
    create <app-name>                       create an application
    new <app-name>                          create an application
    deploy <app-name> <script-path>         deploy an application
    destroy <app-name>                      destroy an application
    rm <app-name>                           destroy an application
    rename <app-name> <new-name>            rename an application
    mv <app-name> <new-name>                rename an application
    users <app-name>                        show application users
    invite <app-name> <role> <email>        invite another user to an application
    accept <token>                          accept an invitation
    routes <app-name>                       output routes
    set-config <app-name> (<key>=<value>)+  set a new environment variable
    get-config <app-name> [key]             get environment variable(s)
    unset-config <app-name> <key>           unset an environment variable
    help [cmd]                              display help for [cmd]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

Commands

stratumn-signup

Starts an interactive prompt to create an account.

  Usage: stratumn-signup [options]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-login

Starts an interactive prompt to log into an account.

The login data is saved to the file ~/.stratumn.json. It is valid for seven days. Making API calls refreshes the token.

  Usage: stratumn-login [options]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-logout

Deletes account login data.

  Usage: stratumn-logout [options]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-whoami

Shows the email of the account currently logged in.

  Usage: stratumn-whoami [options]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-passwd

Starts an interactive prompt to change the password of the account currently logged in.

  Usage: stratumn-passwd [options]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-list

Aliases: stratumn-ls

Lists the applications the account currently logged in has access to.

  Usage: stratumn-list [options]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-show

Aliases: stratumn-view, stratumn-info

Shows the details of an application, its agent script, or the active/last job.

  Usage: stratumn-show <app-name>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number
    -s, --script   show script
    -j, --job      show active or last job

stratumn-metrics

Aliases: stratumn-stats

Shows the metrics of an application.

from and to can be timestamps in milliseconds or strings compatible with moment.js.

  Usage: stratumn-metrics <app-name>

  Options:

    -h, --help         output usage information
    -V, --version      output the version number
    -f, --from <time>  from timestamp (milliseconds) or date
    -t, --to <time>    to timestamp (milliseconds) or date

stratumn-operations

Aliases: stratumn-ops, stratumn-logs

Shows the operations of an application.

from and to can be timestamps in milliseconds or strings compatible with moment.js.

state can be SUCCESS or ERROR.

orders can be ASC or DESC.

format can be JSON or CSV.

  Usage: stratumn-operations [app-name]

  Options:

    -h, --help               output usage information
    -V, --version            output the version number
    -f, --from <time>        from timestamp (milliseconds) or date
    -t, --to <time>          to timestamp (milliseconds) or date
    -l, --limit <int>        limit number of operations
    -s, --state <string>     filter by state
    -z, --fossilized <bool>  show/hide fossilized operations
    -S, --search <string>    search by map id
    -O, --order <string>     specify order
    -F, --format <string>    specify format

stratumn-create

Aliases: stratumn-new

Creates a new application.

  Usage: stratumn-create <app-name>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-deploy

Deploys and/or scales an application.

plan can be SANDBOX, METAMORPHIC, SEISMIC, or TECTONIC.

SANDBOX plan can only have one agent.

  Usage: stratumn-deploy <app-name> [script-path]

  Options:

    -h, --help               output usage information
    -V, --version            output the version number
    -p, --plan <name>        change the plan
    -n, --agent-count <int>  change the number of agents

stratumn-destroy

Aliases: stratumn-rm

Destroys an application.

  Usage: stratumn-destroy <app-name>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-rename

Aliases: stratumn-mv

Renames an application.

  Usage: stratumn-rename <app-name> <new-app-name>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-users

Shows the users that have access to an application.

  Usage: stratumn-users <app-name>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-invite

Invites a user to an application.

role can be ADMIN or COLLABORATOR.

  Usage: stratumn-invite <app-name> <role> <email>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-accept

Accepts an invitation to an application.

  Usage: stratumn-accept <token>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-routes

Lists all routes or a specific route, optionally executes a route.

  Usage: stratumn-routes <app-name> [show-app|create-map|show-link|create-link] [hash] [func] [...args]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number
    -x, --exec     execute route
    -p, --pretty   pretty output when executing
    -d, --debug    add debug flag to urls

When executing routes, arguments will be inflated if their value is:

  • null
  • false
  • true
  • a base 10 number
Example: Show all routes
$ stratumn-routes <appname>
Example: Create a new map
$ stratumn-routes -xp <appname> create-map [arg1] [arg2] [...]
Example: Show an existing link
$ stratumn-routes -xp <appname> show-link <link-hash>
Example: Create a new link
$ stratumn-routes -xp <appname> create-link <prev-link-hash> <func-name> [arg1] [arg2] [...]
Find links of a map with specified tag
$ stratumn-routes -xp <appname> show-map <map-id> -t <tag>

stratumn-set-config

Set a new environment variable for the application.

  Usage: stratumn-config-set <app-name> (<key>=<value>)+

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-get-config

Get either all or a specific existing environment variable set for the application.

  Usage: stratumn-config-set <app-name> [key]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

stratumn-unset-config

Unset an existing environment variable for the application.

  Usage: stratumn-config-unset <app-name> <key>

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

Env variables

STRATUMN_BASE_URL

Stratumn backend API base url, default https://stratumn.net.

STRATUMN_APPLICATION_URL

Stratumn application/agent API base url, default https://%s.stratumn.net. %s is replaced by application name.

STRATUMN_JWT_TTL

Auth token time to live in seconds, default 604800 (one week).

STRATUMN_CONFIG_FILE

Where settings are stored (including auth token), default ~/.stratumn.json.

STRATUMN_PROXY

Server to proxy requests through, default null.

Example values:

http://proxy-server-over-tcp.com:3128
https://proxy-server-over-tls.com:3129
socks://username:[email protected]:9050
socks5://username:[email protected]:9050
socks4://some-socks-proxy.com:9050
pac+http://www.example.com/proxy.pac

STRATUMN_INSECURE

Allow insecure SSL connections, default false.

STRATUMN_DEBUG

Output debug information, default false.