Movement Kit CLI

Command-line tool for bootstrapping and managing Movement Kit projects for Movement blockchain development.

Version: 1.0.18

Overview

Movement Kit CLI (mk) is a command-line tool for quickly setting up dApp projects on Movement blockchain. Built with Bun and TypeScript, it provides:

• 🚀 Quick Project Setup - Bootstrap full-stack dApps in seconds
• 📦 Kit Management - Install and update Movement Kit templates
• 🩺 Diagnostics - Health checks for your development environment
• 🔧 Claude Code Integration - Pre-configured prompts and workflows

Installation

# Using npm
npm install -g movementkit-cli

# Using bun
bun add -g movementkit-cli

# Using yarn
yarn global add movementkit-cli

After installation:

mk --version

Quick Start

# Create a new Movement dApp project
mk new

# Or with options
mk new --dir my-dapp --kit engineer

Commands

mk new

Create a new Movement Kit project.

mk new                          # Interactive mode
mk new --dir my-project         # Specify directory
mk new --kit engineer           # Select kit
mk new -y                       # Use defaults (non-interactive)

mk init

Initialize or update Movement Kit in an existing project.

mk init                         # Interactive mode
mk init --global                # Install globally to ~/.claude
mk init --fresh                 # Clean reinstall
mk init -y                      # Non-interactive with defaults

mk versions

List available Movement Kit versions.

mk versions                     # Show stable versions
mk versions --all               # Include prereleases
mk versions --limit 20          # Show more versions

mk doctor

Run diagnostics and health checks.

mk doctor                       # Full health check
mk doctor --fix                 # Auto-fix issues
mk doctor --check-only          # CI mode (exit 1 on failures)

Global Options

mk --help                       # Show help
mk --version                    # Show version
mk <command> --verbose          # Enable verbose logging

Available Kits

| Kit | Description | |-----|-------------| | engineer | Full dApp development kit with contracts, backend, and frontend |

Project Structure

After running mk new, your project will have:

my-dapp/
├── CLAUDE.md           # Claude Code configuration
├── contracts/          # Move smart contracts
│   ├── Move.toml
│   └── sources/
├── backend/            # Express.js API server
│   ├── package.json
│   └── src/
├── frontend/           # React + Vite frontend
│   ├── package.json
│   └── src/
├── docs/               # Documentation and references
├── plans/              # Architecture plans
└── templates/          # Code templates

Claude Code Commands

After setup, use these slash commands in Claude Code:

| Command | Description | |---------|-------------| | /plan | Create architecture plan | | /cook | Generate full dApp code | | /cook:contracts | Generate Move contracts | | /cook:backend | Generate backend API | | /cook:frontend | Generate React frontend | | /test | Run all tests | | /review | Security audit | | /deploy-full | Deploy to Movement | | /watzup | Check project status |

Development

# Clone and install
git clone https://github.com/cuongpo/movement-kit
cd movement-kit/movementkit-cli
bun install

# Run in development
bun run dev new --kit engineer

# Build
bun run build

# Test
bun test

Requirements

• Node.js 18+
• Bun 1.3.2+ (recommended)
• Movement CLI (optional, for deployment)
• Git

License

MIT