CLI Reference

mot is the Motanamy command-line tool. Use it to create, run and publish plugins for EA, SA and OS.

npm install -g motanamy-cli   # requires Node.js 18+
mot --version

Commands at a glance

Command	What it does
mot create	Create a new plugin project
mot link	Link your installed Motanamy apps
mot token	Manage your API tokens
mot dev	Run your plugin inside the linked app
mot build	Package a plugin as a ZIP (EA only)
mot publish	Publish to the Motanamy Store
mot merge	Merge several EA plugins into one package
mot install-deps	Install plugin dependencies and run setup scripts
mot plugins	List your published plugins
mot download	Download a plugin from the store
mot deploy	Deploy a docker-compose project to Motanamy Cloud
mot whoami	Show the active token and linked apps

Plugin workflow

mot create

Creates a new plugin project.

mot create my-plugin              # asks for the name and type
mot create my-plugin --type EA    # --type: EA | SA | OS

If the folder already exists, you're asked to confirm before it's overwritten.

mot link

Tells the CLI where your installed Motanamy apps live. Link at least one app before you run mot dev.

mot link add     # link an app
mot link list    # show linked apps

mot token

Manages your API tokens. Get a token from core.motanamy.com → Settings.

mot token add      # add a token (your first one is activated automatically)
mot token list     # list tokens; the active one is marked
mot token switch   # change the active token
mot token remove   # remove a token

mot dev

Runs your plugin inside the linked app for testing. Run it from inside the plugin folder.

cd my-plugin
mot dev

mot build

Packages the plugin as a ZIP that's ready to publish. Currently EA only.

mot build

mot publish

Publishes your plugin to the Motanamy Store. Requires an active token.

mot publish

More commands

mot merge

Merges the EA plugins in the current directory into a single deployable package.

mot install-deps

Installs plugin dependencies and runs any configured setup scripts.

mot plugins

Lists the plugins you've published to the store.

mot download

Downloads one of your plugins from the store to your machine.

mot whoami

Shows the active token and the linked app paths.

Motanamy CLI — Current Configuration

  ✓ Logged in as:  my-token  (eyJhbG...WjsQ)

  Application links:
    ✓ SA  →  /Applications/Motanamy-SA
    ✓ EA  →  /Applications/MotanamyEA
      OS  →  (not set)

mot deploy

Deploys a docker-compose project to Motanamy Cloud.

mot deploy                    # from the current directory
mot deploy ./my-project       # from a folder
mot deploy ./my-project.zip   # from a ZIP file

Option	Description
--name <name>	Project name. Taken from the config or folder name if you leave it out
--host <url>	API host (default https://cloud.motanamy.com)
--user <id>	Owner user ID. Falls back to project.userId, then your own account
--update	Update an existing project
--skip-deploy	Upload only, without deploying
--deploy	Force a deploy after --update

Optional motanamy.config.json:

{
  "project": { "name": "my-project", "userId": "15" },
  "deploy": {
    "include": ["apps/api/dist/**", "../database"],
    "exclude": ["node_modules", ".env"]
  },
  "preserveData": ["volumes/data"]
}

To leave files out of the upload, list them in .motanamyignore, which works like .gitignore.

Configuration & help

The CLI stores its settings in ~/.motanamy-cli-config.json. If that file gets corrupted, the CLI backs it up to .motanamy-cli-config.json.bak and starts with fresh settings.

mot --help            # list all commands
mot help <command>    # help for one command