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

``bash


Using npm

npm install -g movementkit-cli

Using bun

bun add -g movementkit-cli

Using yarn

yarn global add movementkit-cli
`

After installation:

`bash
mk --version
`

Quick Start

`bash


Create a new Movement dApp project

mk new

Or with options

mk new --dir my-dapp --kit engineer
`

Commands

$3

Create a new Movement Kit project.

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

$3

Initialize or update Movement Kit in an existing project.

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

$3

List available Movement Kit versions.

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

$3

Run diagnostics and health checks.

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

$3

`bash
mk --help # Show help
mk --version # Show version
mk --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

`bash


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