Ark

This site is private. Enter the password to continue.

Getting Started
CLI Reference
Package Format
Audit System
Publishing
docs / getting-started / installation

Installation

System requirements

Ark requires Node.js 18 or later. npm, pnpm, and yarn are all supported.

RequirementMinimumRecommended
Node.js18.0.020.x LTS
npm8.0.010.x
OSmacOS 12, Ubuntu 20.04macOS 14+, Ubuntu 22.04+
Disk200 MB1 GB (for packages)

Install globally

The recommended approach. Install once, use everywhere.

Terminal
$ npm install -g ark-pm

# Verify installation
$ ark --version
ark-pm/1.0.0 darwin-arm64 node-v20.11.0

Use with npx

No installation required. Run any Ark command directly with npx. Useful for one-off commands or CI environments.

Terminal
$ npx ark-pm search voice
$ npx ark-pm audit --static
$ npx ark-pm install voice-writer
npx vs global install: npx always fetches the latest version. Global install gives you a fixed version — better for consistent tooling across a team.

Local storage

Ark stores installed packages and configuration in your home directory. No system-wide files are modified.

~/.ark/ structure
~/.ark/
├── packages/           # installed packages
│   ├── voice-writer/
│   └── daily-recap/
├── config.json         # auth token, preferences
└── cache/              # downloaded archives (clearable)

Update Ark

Terminal
$ npm update -g ark-pm

# Or reinstall to latest
$ npm install -g ark-pm@latest

Uninstall

Terminal
$ npm uninstall -g ark-pm

# Remove local data (optional)
$ rm -rf ~/.ark