@getaimd/cli

The official CLI for AIMD Marketplace — install runbook packages, execute Self-Executing Markdown (SEM) files, and run security compliance audits on your workspace.

Installation

npm install -g @getaimd/cli

Quick Start

# Log in to your AIMD account
aimd login

# Initialize AIMD in your project
aimd init

# Install a runbook package from the registry
aimd install workspace-slug/listing-slug

# Run a Self-Executing Markdown runbook interactively
aimd run ./my-runbook.sem.md

# Scan your workspace for secrets, PII, and CVEs
aimd scan

Commands

| Command | Description | | :--- | :--- | | aimd login | Authenticate against your AIMD account | | aimd init | Initialize aimd.json config in the current directory | | aimd install [pkg] | Install a registry package or restore all aimd.json dependencies | | aimd run <file> | Start the interactive SEM step-by-step wizard | | aimd scan | Run a full compliance audit (secrets, PII, CVEs) | | aimd push | Run pre-flight scan and upload a new draft version | | aimd pull <id> | Download and restore a published version | | aimd keys <action> | Administer license keys (list, revoke, reset) | | aimd local <subcommand> | Manage offline cache of downloaded packages | | aimd test <file> | Validate a runbook before publishing | | aimd import <source> | Auto-convert a markdown guide into a SEM runbook |

Self-Executing Markdown (SEM)

AIMD runbooks are standard Markdown files with executable shell blocks. Tag a block with execute to make it runnable:

```bash execute
echo "Hello from AIMD!"
```

Run it interactively:

aimd run ./my-runbook.sem.md

The wizard walks you through each step, prompts for variables, and supports --resume to pick up where you left off.

Security & Compliance

aimd scan audits your workspace for:

• Secrets — API keys, tokens, database URIs (Shannon entropy detection)
• PII — emails, phone numbers, SSNs, credit card numbers (Luhn-validated)
• CVEs — known vulnerabilities in npm, PyPI, and Go dependencies via Google OSV

Requirements

• Node.js >= 18.0.0

License

MIT