machin-hart
The agent-first artifact host — publish self-contained HTML or JSX to a live, shareable URL from any terminal agent on your infrastructure in one CLI call.
Ficha actualizada 23 sept 2026, 13:07 · upstream 23 sept 2026, 12:45 · release v0.4.3
Qué es machin-hart
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
hart is an agent-first, CLI-only, open-source artifact host built as a single static MFL binary. It serves as both the client and hosting daemon for publishing self-contained HTML pages that render with full CSP sandboxing. Unlike traditional artifact hosts (open, untrusted), hart neuters its output by default — inline styles, scripts, and images are embedded to prevent external injection attacks. The tool is designed for terminal agents such as Claude Code, Cursor, aider, and custom SDK agents, enabling them to publish dashboards, reports, call sheets, or mockups without a build step or dependency on third-party hosting platforms.
- Publishing self-contained HTML dashboards that render with full CSP sandboxing
- Sharing versioned artifact pages from terminal agents (Claude Code, Cursor, etc.)
- Creating shareable mockups and call sheets without external dependencies
- Hosting analytics or reporting artifacts in a secure, isolated environment
- Distributing static assets like charts, reports, or interactive UI components
- Single binary (MFL) that serves both as the publish client and hosting daemon — no build step required
- CSP-sandboxed output by default: inline styles, scripts, images, and fonts are embedded to prevent external injection attacks
- Agent-first design with a drop-in skill for Claude/Cursor sessions and MCP-native clients
- Versioned artifact storage where re-publishing appends version numbers without overwriting previous artifacts
- Team visibility via X-Hart-Member-Key header or team-based sign-in, eliminating shared secrets
- Self-hosted with SQLite persistence, configurable domains, and optional Traefik integration for multi-tenant deployments
- No support for external dependencies (CDN scripts, remote stylesheets, web fonts) — all content must be self-contained
- No server-side rendering or dynamic generation beyond static HTML/JSX files
- Self-hosted instances require manual deployment and maintenance of the binary and database
- Team visibility requires a paid Pro tier; free instances lack team-based access control
- Limited support for complex interactivity (e.g., React Router, state management) — only static page rendering is supported
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Deploy hart as a systemd service with environment variables set: HART_URL=http://localhost:8799, HART_DB=~/.hart.db, and optional HART_TOKEN for gatekeeping. Use `./scripts/deploy.sh --build --db-backup` to stage updates, verify the binary transfer, swap binaries, back up SQLite, restart, and health-check. For multi-tenant deployments, use Traefik with `--emit-traefik` flags to generate host-only router blocks for each domain. Public instances can be exposed behind reverse proxies (Traefik + Cloudflare) with automatic HTTPS via Let's Encrypt. Always rotate HART_TOKEN on production and enable read timeouts in the proxy configuration.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.