Moltengine CLI

Command-line interface for Moltengine — The WP Engine for AI Agents.

Installation

Via npm (Recommended)

npm install -g moltengine-cli

Via npx (No Install)

npx moltengine-cli status

Direct Download

curl -fsSL https://moltengine.com/install.sh | bash

Configuration

Set your environment variables:

export MOLTENGINE_API="https://api.moltengine.com"
export MOLT_TENANT_KEY="your-api-key-here"

Add to your shell config (~/.bashrc or ~/.zshrc) for persistence:

echo 'export MOLTENGINE_API="https://api.moltengine.com"' >> ~/.bashrc
echo 'export MOLT_TENANT_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Usage

# Check status, usage, and pending approvals
moltctl status

# Show tenant and plan information
moltctl whoami

# View detailed usage vs plan limits
moltctl usage

# List and manage pending approvals (Team+ plans)
moltctl approvals list
moltctl approvals approve 1
moltctl approvals deny 2

# List deployments
moltctl deployments

# Upgrade your plan
moltctl upgrade team

# Show help
moltctl help

Commands

| Command | Description | |---------|-------------| | moltctl status | Show status, usage stats, and pending approvals | | moltctl whoami | Show current tenant and plan information | | moltctl usage | Show detailed usage vs plan limits | | moltctl approvals | List and manage pending approvals (Team+) | | moltctl deployments | List recent deployments | | moltctl upgrade [plan] | Upgrade to a higher plan | | moltctl audit | Search and export audit logs (Team+) | | moltctl policies | Manage security policies (Team+) | | moltctl help | Show help message |

Approvals (Team+ Plans)

On Team plan and above, risky actions are held for approval instead of being blocked:

# List pending approvals
moltctl approvals list

# Approve an action
moltctl approvals approve 1

# Deny an action
moltctl approvals deny 1

On Starter plan, risky actions are blocked automatically (Safe Mode). Upgrade to enable approvals:

moltctl upgrade team

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MOLTENGINE_API | Yes | API URL (e.g., https://api.moltengine.com) | | MOLT_TENANT_KEY | Yes | Your tenant API key | | MOLTENGINE_WEB | No | Web URL for upgrade links (default: https://moltengine.com) |

Getting Your API Key

Your API key is displayed on the success page after completing checkout at moltengine.com.

If you've lost your API key, contact [email protected].

Development

# Clone the repo
git clone https://github.com/moltengine/moltengine.git
cd moltengine/cli

# Install dependencies
npm install

# Run locally
npm start -- status

# Link for local development
npm link
moltctl status

Publishing (Maintainers)

# Bump version
npm version patch  # or minor, major

# Publish to npm
npm publish

Requirements

• Node.js 20+

License

MIT

Support

• Email: [email protected]
• Docs: https://docs.moltengine.com