From your terminal to a shared 3D view.
Blind turns meshes, notes and diagnostics into a link you can open on a phone or desktop. An agent can create the scene from the CLI; a person can rotate, inspect, annotate and share what they see.
- Rotate the model, inspect a section, or mark a detail directly on its surface.
- Put Markdown, JSON, images and logs beside the geometry for context.
- Share the view and its PNG. Original files stay on their source machine or object store.
Install the latest release on macOS (Apple Silicon or Intel) or Linux x86_64:
curl -fsSL https://raw.githubusercontent.com/hx-w/blind/main/install.sh | shStart the server:
blind serveIn another terminal on the same machine, as the same user, register locally and share a small sample mesh:
blind join --local
curl -fsSLo demo.ply https://raw.githubusercontent.com/hx-w/blind/main/tests/fixtures/tetra.ply
blind share demo.ply --format jsonOpen viewer_url in your browser, or on a phone that can reach this machine.
Use image_url for a PNG of the same view. Keep owner_url private.
Replace demo.ply with your own PLY, STL, OBJ or PTS file.
Already using a team server? Follow Client registration instead. To host one, see team server setup.
blind share model.ply notes.md metrics.json --format json
blind share --config collection.json --format jsonDocuments open alongside the model. Collections keep several independent scenes under one link. See components and collection configuration for examples.
Links last seven days by default and depend on their original sources remaining available and unchanged. Sharing and link lifetime explains permanent links, reshares and source changes.
| I want to… | Guide |
|---|---|
| Share files, label groups, script an agent or create collections | CLI guide |
| Inspect, annotate, compare sections or use the viewer on a phone | Viewer guide |
| Display Markdown, JSON, images, Mermaid/DOT, HTML or custom content | Scene components |
| Set up a team server, connect machines, update or troubleshoot | Client and Server |
| Read from S3-compatible storage or signed download domains | Object storage |
| Extend Blind with Client or Server resolvers and URL-scoped components | Plugins |
| Integrate with HTTP or understand saved scene state | API · Sharing contract |
| Build, test or contribute | Development · Architecture |
Releases · Changelog · Security · MIT license
