@chamuka-labs/drawit-cli

A command-line tool for validating, inspecting, and exporting .drawit diagram files. Part of the Chamuka DrawIt ecosystem.

Installation

npm install -g @chamuka-labs/drawit-cli

Once installed, both drawit and chamuka-drawit are available as CLI commands.

Commands

drawit validate <file>

Parse and validate a .drawit file.

drawit validate my-diagram.drawit
drawit validate --strict my-diagram.drawit   # Full Zod schema validation
drawit validate --format json my-diagram.drawit

drawit inspect <file>

Show a structured summary of a .drawit file.

drawit inspect my-diagram.drawit
drawit inspect --elements my-diagram.drawit  # Include element ID listing
drawit inspect --format json my-diagram.drawit

drawit export <file>

Export to a different format.

drawit export my-diagram.drawit --format svg --output my-diagram.svg
drawit export my-diagram.drawit --format json --output my-diagram.json
drawit export my-diagram.drawit --format ndjson --output clean.drawit

drawit create <file>

Scaffold a new .drawit file.

drawit create new-diagram.drawit
drawit create new-diagram.drawit --template flowchart --name "My Flow" --width 1200 --height 800

drawit merge <file1> <file2> [...]

Combine multiple .drawit files into one.

drawit merge part1.drawit part2.drawit --output combined.drawit
drawit merge *.drawit --layout vertical --gap 80 --output combined.drawit

drawit map

Generate a dependency map diagram from a codebase.

drawit map --output dependencies.drawit
drawit map --root ./src --output map.drawit

drawit schema

Show or validate against the DrawIt JSON schema.

drawit schema
drawit schema --validate my-diagram.drawit

drawit deps

Analyze and visualize package dependencies.

drawit deps --output deps.drawit

drawit flow

Generate a control-flow diagram from source code.

drawit flow src/index.ts --output flow.drawit

drawit routes

Generate a routes diagram from a Next.js or Express app.

drawit routes --output routes.drawit

Global Options

• --format text|json — Output format for text commands (default: text)
• --stdin — Read diagram from stdin instead of a file
• --output <path> / -o <path> — Write output to a file

Pipe-Friendly

cat diagram.drawit | drawit validate --stdin
cat diagram.drawit | drawit export --stdin --format svg > output.svg
drawit validate diagram.drawit && drawit export diagram.drawit --format svg -o out.svg

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success / valid | | 1 | Errors found / invalid file |

Supported File Formats

The CLI handles both .drawit file formats:

• NDJSON — one JSON object per line (generated by the CLI and Claude Code skill)
• JSON — pretty-printed multi-line JSON with elements array (generated by the web app)

Requirements

Node.js 18 or later.

Related

• Web App — drawit.chamuka.ai — full AI-powered diagram editor
• VS Code Extension — ChamukaLabs.vscode-drawit-viewer — view .drawit files in VS Code
• npm package — @chamuka-labs/drawit-cli

License

Proprietary — © 2026 Chamuka Inc. All rights reserved. Unauthorized copying, distribution, or modification is strictly prohibited. For licensing inquiries contact [email protected].