Getting started
PlatformCosmo needs Node.js 22.12 or newer.
With Claude Code
/plugin marketplace add mirastacklabs-ai/platformcosmo
/plugin install platformcosmo@platformcosmoThen ask for a diagram:
/platformcosmo:diagram a RAG pipeline with a vector DB and a guardrailClaude writes rag.cosmo.json, runs pcosmo validate, fixes any problems and runs pcosmo build. See the plugin guide.
From an image
Attach a screenshot, an exported diagram or a whiteboard photo, or name its path:
/platformcosmo:diagram draw this as a PlatformCosmo diagram: ./sketch.pngClaude first lists the components, groups, connections and reading order it sees, then writes the spec, validates it and builds the SVG. The image is redrawn in PlatformCosmo's isometric style (not a pixel copy), labels are kept verbatim (obvious typos fixed, long ones shortened and listed as assumptions), and steps are added only when the image shows a sequence such as numbered arrows. Claude ends with what it read and any assumptions, so you can correct them. Add "keep the layout" to ask for a best-effort match of the original positions. PlatformCosmo sends the image nowhere: Claude reads it as part of your conversation, like any attachment, and no tool uploads it elsewhere.
With the CLI
pcosmo init my-system.cosmo.json # write a starter spec
pcosmo validate my-system.cosmo.json # schema and semantic checks
pcosmo build my-system.cosmo.json # writes my-system.svg next to the specOpen my-system.svg in a browser, or use it as an image:
<img src="my-system.svg" alt="My system architecture" />Start from the gallery instead of a blank file:
pcosmo examples # list gallery specs
pcosmo examples copy rag-pipeline # copy one into the current directory
pcosmo init --list # list lesson templatesEditor completion
Specs start with "$schema": "https://platformcosmo.io/schema/v1.json", which gives completion and validation in VS Code and other JSON-schema-aware editors. The CLI never fetches that URL; validation is built in.
Next
- Spec format and the CLI reference
- Icons, including AWS, Azure and GCP packs
- Gallery