# @matrix/mx-cli

Matrix CLI for package management.

## Installation

```bash
cd packages/mx-cli
npm install
npm run build
```

## Usage

```bash
mx --help
mx --version
mx init                 # Initialize a new Matrix package (B013)
mx actor <name>         # Scaffold a new actor package (B014)
mx install <package>    # Install a package (future)
mx fork <package>       # Fork and install a package (future)
mx publish              # Publish a package (future)
mx list                 # List installed packages (future)
```

## Development

- **Build**: `npm run build`
- **Test**: `npm test` (requires Node spawn capability)

## Architecture

See:
- `ARCHITECTURE/protocol/MATRIX-PROTOCOL-10.md` (MXTYPE-1 - Homoiconic Type System)
- `ralph/beads/cycle-0002-B012-mx-cli-package-foundation.md`
- `ralph/beads/cycle-0002-B013-mx-init-command.md`
- `ralph/beads/cycle-0002-B014-mx-actor-scaffold.md`

## Status

- **B012**: Foundation complete (package structure, CLI routing, help/version)
- **B013**: `mx init` implemented (manifest + directory scaffolding + validation)
- **B014**: `mx actor` implemented (actor package scaffold with examples/skills/tests)