Installation

Prerequisites

On Linux the keychain uses libsecret. If you see a "keychain unavailable" warning on login, install it:

# Debian / Ubuntu
sudo apt install libsecret-1-dev

# Fedora / RHEL
sudo dnf install libsecret-devel

Without it the CLI falls back to a ~/.config/i99dash/sdk.json file with chmod 0600 — functional, but the access token is on disk in plain text. See Authentication for details.

Install the CLI

One-shot, no global install:

pnpm dlx i99dash init my-app

init interactively prompts for a catalog category (one of 10 canonical slugs — see Categories + tags) and scaffolds a placeholder icon at src/assets/icon.svg you can swap for your real artwork. CI / non-interactive runs: pass --yes (defaults to other) or --category <slug> to pre-answer.

Or install it in a project:

pnpm add -D i99dash

Or globally, if you want i99dash on your $PATH:

pnpm add -g i99dash
# then: i99dash --help

Install the runtime in an existing app

If you already have a Next.js / Nuxt / vanilla project and just want the typed bridge wrapper:

pnpm add i99dash

Usage: MiniAppClient.

Verify

i99dash --version
i99dash --help

Both should print without errors. If they don't, file an issue with your Node version and OS.