# 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

### `mk new`

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)
```

### `mk init`

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
```

### `mk versions`

List available Movement Kit versions.

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

### `mk doctor`

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)
```

### Global Options

```bash
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

```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