Fold CLI

Fold CLI syncs your local AI agent stack with Fold and installs reusable agent workflows.

Quick Start

Run without installing:

npx foldhub login

Or install globally:

npm install -g foldhub
fold login

By default, the CLI connects to https://foldhub.cn. For local development, override the API URL:

FOLD_API_URL=http://localhost:3000 fold login

Common Commands

fold login
fold scan
fold sync
fold usage scan
fold usage sync
fold upgrades
fold peers
fold peers --json
fold assets --json
fold pull <slug>

Peers nearby

After login, see what friends and colleagues are installing (adoption count, who adopted, recent activity):

fold peers
fold peers --json   # machine-readable for agents

Web UI: https://foldhub.cn/app/peers

Friends must be on Fold and allow adoption signals in privacy settings. Invite links help you appear in each other's peer feed.