{"slug": "show-hn-open-artifact-view-and-share-your-llm-docs-and-artifacts", "title": "Show HN: Open-artifact – view and share your LLM docs and artifacts", "summary": "Open Artifact is a new open-source tool that gives LLM-generated documents and artifacts a shareable URL, enabling private sharing, line-level commenting, and agent-driven revision. The project, hosted at open-artifact.com, allows users to self-host or use the free hosted instance, and supports publishing from coding agents via CLI or MCP endpoint.", "body_md": "Your coding agent writes a report, a design doc, a dashboard. Right now that lands as a file on your laptop that nobody else can see.\n\nOpen Artifact gives it a URL. The agent publishes, you get a link, you share it with the people who need to read it. They comment on the exact paragraph they are reacting to, and the agent reads those comments back and revises. You host all of it yourself.\n\n**Publish from the agent.** One command, or the bundled skill so the agent does it without being asked.**HTML and Markdown.** HTML runs in a sandbox with no access to your session. Markdown is rendered with headings, tables and syntax highlighting.**Share deliberately.** Private by default. Open it to named people, to everyone at your email domain, or to anyone with the link.**Comment on a specific line.** Comments hold their position when the document is republished, and say so plainly when the text they pointed at is gone.**Feedback loop.** The agent reads the comments and publishes a new version.\n\nDon't want to run a server? The hosted instance is live and free:\n** open-artifact.com**. Sign up with your email,\nconnect your assistant, and start publishing — nothing to deploy. Everything\nbelow this is for when you'd rather host your own.\n\n```\ngit clone https://github.com/iBala/open-artifact.git\ncd open-artifact\npnpm install\npnpm --filter @open-artifact/server dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000). With no mail server configured, sign-in codes are\nprinted to the terminal, so you can sign in and click around without setting up\nanything else.\n\nEverything you need is in `deploy/`\n\n.\n\n```\ncp deploy/env.example .env      # then fill in BASE_URL, SESSION_SECRET, SMTP\ndocker compose -f deploy/docker-compose.yml up -d\n```\n\nTwo things to know before you go live:\n\n**Put a reverse proxy in front of it.** The container binds to localhost only,\non purpose. Terminate TLS with Caddy, nginx or Traefik and forward to it.\n\n**You need a mail server.** Sign-in codes and share notifications go out over\nSMTP. Amazon SES, Postmark, Fastmail, your own — anything that speaks SMTP.\nWithout it, nobody can sign in.\n\nThen prove the install works:\n\n```\n./deploy/smoke.sh https://artifacts.example.com\n```\n\nThat signs in, publishes, checks the sandbox headers are really being sent, shares, comments, republishes and confirms the comment kept its place. If it passes, the instance is good.\n\n`SIGNUP_MODE`\n\ndecides. `invite-only`\n\nis the default: an account is created only\nfor someone an artifact was shared with. `domain-allowlist`\n\nopens it to listed\nemail domains. `open`\n\nlets anyone in. Every setting is explained in\n`deploy/env.example`\n\n, and the server refuses to boot with a clear message if\nsomething is missing or contradictory.\n\nTwo ways in, depending on whether the assistant has a terminal.\n\n**Has a terminal** (Claude Code, Codex, Cursor, and friends) — hand your\nassistant one sentence and let it set itself up:\n\nSet up Open Artifact for me. Install the CLI —\n\n`npm install -g open-artifact --registry https://registry.npmjs.org/`\n\n— then read`https://open-artifact.com/setup.md`\n\nand follow it.\n\nEvery instance serves its own `/setup.md`\n\n, so swap in your own address when you\nself-host. That page walks the assistant through installing, signing you in, and\nsaving the skill. The skill itself lives in `skill/`\n\n.\n\n**No terminal** (Claude on the web, ChatGPT) — the hosted MCP endpoint. Add\n`https://artifacts.example.com/mcp`\n\nas a custom connector in the app's\nsettings; the instance walks the connector through OAuth and shows a consent\npage. A connection can publish, update and share its own documents and read\ntheir comments — and deliberately cannot delete anything, make anything\npublic, or read documents other people shared with you. `MCP_DESIGN.md`\n\nhas\nthe reasoning. Header-capable tools can skip OAuth: mint a token under\nSettings → Sessions → \"Connect an assistant\" and send it as\n`Authorization: Bearer …`\n\n.\n\n| Folder | What it is |\n|---|---|\n`packages/server` |\nHono API, SQLite via Drizzle, auth, sharing, comments |\n`packages/web` |\nReact and Vite front end |\n`packages/cli` |\nThe `open-artifact` command the agent runs |\n`packages/shared` |\nTypes and validation both sides use |\n`packages/e2e` |\nPlaywright tests against a real browser |\n`skill/` |\nThe agent instructions |\n`deploy/` |\nCompose file, environment template, smoke test |\n\nThe database is one SQLite file. Back that file up and you have backed up the\nwhole instance. The compose file includes a nightly backup that uses SQLite's\nown `.backup`\n\ncommand, not a file copy, because copying a live database gives\nyou a corrupt one.\n\n```\npnpm install\npnpm test          # unit and integration\npnpm lint\npnpm typecheck\npnpm --filter @open-artifact/e2e test    # browser tests\n```\n\nTests come first here. If you are adding behaviour, the test that describes it should exist before the code that satisfies it.\n\nOpen an issue on GitHub: ** github.com/iBala/open-artifact/issues**.\nBug reports, feature requests and rough ideas are all welcome — that's where we\ntrack what to build next.\n\nOpen Artifact is **fair-code**, under the [Sustainable Use License](/iBala/open-artifact/blob/main/LICENSE) —\nthe same licence n8n uses. You can self-host and modify it for free, including\ninside a company. You cannot sell it or run it as a commercial hosted service\nwithout a commercial licence. For that, or for an enterprise arrangement\n(SSO/SAML, audit logs, dedicated hosting), email\n[hello@open-artifact.com](mailto:hello@open-artifact.com).", "url": "https://wpnews.pro/news/show-hn-open-artifact-view-and-share-your-llm-docs-and-artifacts", "canonical_source": "https://github.com/iBala/open-artifact", "published_at": "2026-07-23 20:03:44+00:00", "updated_at": "2026-07-23 20:22:49.956315+00:00", "lang": "en", "topics": ["developer-tools", "ai-tools", "artificial-intelligence"], "entities": ["Open Artifact", "open-artifact.com", "Claude Code", "Codex", "Cursor", "ChatGPT"], "alternates": {"html": "https://wpnews.pro/news/show-hn-open-artifact-view-and-share-your-llm-docs-and-artifacts", "markdown": "https://wpnews.pro/news/show-hn-open-artifact-view-and-share-your-llm-docs-and-artifacts.md", "text": "https://wpnews.pro/news/show-hn-open-artifact-view-and-share-your-llm-docs-and-artifacts.txt", "jsonld": "https://wpnews.pro/news/show-hn-open-artifact-view-and-share-your-llm-docs-and-artifacts.jsonld"}}