NotHolyDocumentation
Open chat

NotHoly CLI

A repository-distributed client for the same conversations and durable work.

Distribution

CLI 0.1.0 requires Node.js 24 or later. From an authorized repository checkout, use the build and source command below. Local npm tarballs are tested separately; no public npm publication or marketplace release is claimed.

Shell
npm ci
npm run build
npm run cli -- --help

Commands and profiles

auth login reads a key from stdin; auth status and config never print it. history lists conversations, resume follows an existing run, and mode selects a profile default. Use --profile NAME for isolated local preferences. A selected file requires --file PATH and --allow-file; Reverse uses --binary-file and Pentest uses --engagement. No command discovers or uploads a repository automatically.

Credentials and funding

Use a scoped customer key and explicit public endpoint. Subscription-funded CLI work requires chat:write in addition to relevant run/session scopes. API-wallet work remains separately accounted. Doctor never prints the secret.

Local permissions

Selecting a repository does not authorize arbitrary upload or shell execution. Local files, commands and approved patches require the appropriate explicit companion permissions. Capabilities still in development are not presented as shipped.