Morpheon Code

A Node.js CLI that talks to the live Morpheon router. Built for AEC professionals (BIM, VDC, scan-to-BIM, clash, RFI, proposals).

Install

Requires Node 18 or newer.

npm install -g morpheon-cli-1.0.0.tgz

or from a distribution tarball:

npm install -g C:\Users\IanMartin\Downloads\morpheon-cli.tgz

After install, the morpheon command is available globally.

Quick start

morpheon rfi "Mech rm 204: 18in duct clashes with PT slab at grid E-7"
morpheon clash "duct vs PT slab, 2nd floor west wing, clearance 1.5in"
morpheon classify "24in galvanized rectangular duct w/ flanged ends"
morpheon proposal "scan-to-BIM, 40k sf warehouse, LOD 300" --out=proposal.docx

Commands

| Command | Task | Default tier | | ---------- | -------------------------- | -------------------- | | rfi | Draft RFI / response | Claude Sonnet · T2 | | clash | Explain BIM clash | Llama 70B · T1 | | qa | QA / QC naming check | Llama 70B · T1 | | proposal | Client proposal draft | Claude Sonnet · T2 | | risk | Risk assessment | Claude Sonnet · T2 | | classify | Classify / name element | Edge AI · T0 · free | | sop | Summarize an SOP | Llama 70B · T1 | | email | Draft an internal email | Llama 70B · T1 | | synth | Multi-doc synthesis | Claude Sonnet · T2 | | ask | Free-form; needs --task | Depends on --task |

Flags

| Flag | Purpose | | ------------------ | ----------------------------------------------------------- | | --out=FILE | Save output. Extension picks format: .docx, .pdf, .txt, .md. | | --model=MODEL | Override routing: opus, sonnet, llama, edge. | | --task=TASK | With ask, set the explicit task_type. | | --max-tokens=N | Response length cap (default 2048). | | --json | Print the raw router JSON. | | --verbose | Print tier, model, cost, and latency to stderr. | | -h, --help | Show help. |

Environment

| Variable | Purpose | | ------------------ | --------------------------------------- | | ROUTER_API_KEY | Override the default router API key. | | ROUTER_API_URL | Override the router endpoint URL. |

Examples

Draft a bulletproof RFI and save it to Word:

morpheon rfi "Mech rm 204: 18in duct clashes with PT slab at grid E-7" --out=rfi.docx

Write a proposal with Opus (highest stakes):

morpheon proposal "scan-to-BIM, 80k sf hospital addition, LOD 350, 6-week delivery" --model=opus --out=proposal.pdf

Explain a clash quickly on free tier:

morpheon clash "duct vs PT slab, 2nd floor west wing, clearance 1.5in" --model=edge --verbose

Free-form synthesis:

morpheon ask "compare Revit vs Archicad for a 15-person firm" --task=synth --model=opus

Get raw router metadata:

morpheon qa "FAM-Duct-Galv-24" --json

Output formatting

By default Morpheon prints clean professional prose. The CLI strips em and en dashes, and bold markers are stripped in terminal mode. When exporting to .docx or .pdf, bold is rendered as real bold runs. Numbered lines stay on their own lines.

Troubleshooting

• request timed out after 45s → the router or upstream model is slow. Retry.
• router error 401 → the ROUTER_API_KEY is missing or invalid.
• docx export needs the "docx" package installed → run npm install inside the global package directory, or reinstall the tarball.