plannotator/artifact-server

The self-hosted, open-source alternative to Claude Code artifacts.

142

stars

311

commits

TypeScript

primary language

Sep 11, 2026

updated

artifactserver.com
agent-artifacts
ai-artifacts
artifacts
claude-code
codex
opencode
pi

README

Artifact Server

Artifact Server

The open-source, self-hostable alternative to Claude Code artifacts.

Artifact Server gives people and agents one place to publish, review, comment on, version, and share the artifacts they create while building products. Its built-in MCP server gives agents direct access to the same work.

Run it on a laptop for one developer. Deploy it for a private team on Cloudflare, one server, Kubernetes, AWS, or Google Cloud.

Artifact Server is created with Plannotator      Plannotator Workspaces is the planning layer for your software factory

Contents

Why Artifact Server

Teams now use HTML, images, and video for plans, mockups, prototypes, code reviews, and other work created during product development. That work quickly becomes disorganized, and providers try to lock it inside their platforms.

Artifact Server gives teams a self-hosted place to organize and collaborate on that work. Store artifacts by project, share them, comment on them, and keep control of the files and data.

Built for AI agents and team collaboration

Claude    Codex    Cursor    GitHub Copilot    Pi    OpenCode

AI agents connect to Artifact Server through its built-in MCP server    Team members add comments to exact artifact versions

Artifact Server includes a built-in MCP server and a portable Agent Skill. Agents publish and update versioned artifacts. Teams review, comment on, and share the same work.

Connect the agent and install the skill:

artifactserver connect
npx skills add plannotator/artifact-server

Then ask:

/artifact-server upload that HTML design doc

The agent returns the full-screen review link first. Read the MCP guide for source checkouts, remote servers, permissions, and supported operations.

Live session delivery is available from source for Pi and Claude Code Channels. Claude Channels require its research-preview development flag and, on managed plans, the organization policy. The OpenCode adapter is not release-qualified; live-host verification and contributions are welcome.

Artifact Server has native Pi support for live integrated feedback Artifact Server supports live feedback through the Claude Code Channels research preview OpenCode live-host verification, features, and pull requests are welcome

Cloudflare and Artifact Server

Cloudflare is the main hosted deployment target. Cloudflare Artifacts can add private Git-backed history for selected projects. It is off by default and currently requires closed beta access.

Cloudflare Artifacts provides optional Git-backed history

Cloudflare is optional. Artifact Server also runs locally, on Compose, on Kubernetes, on AWS, and on Google Cloud.

Artifact Server supports Cloudflare, Docker Compose, Kubernetes, AWS, and Google Cloud

Deploy it for a team

Every remote deployment uses one trusted application origin and one isolated wildcard content domain.

DeploymentData layerGuide
CloudflareD1 and R2Cloudflare guide
Compact ComposeSQLite and one file volumeCompose guide
External-storage ComposePostgreSQL and S3-compatible storageCompose guide
KubernetesPostgreSQL and object storageHelm guide
AWSECS, RDS, and S3AWS Pulumi guide
Google CloudCloud Run, Cloud SQL, and Cloud StorageGoogle Cloud Pulumi guide

Azure teams deploy through the Helm chart on AKS; there is no separate Azure installer. Azure Blob Storage is available as a preview adapter and has not passed live Azure qualification.

Read the deployment guide for shared requirements, storage choices, authentication, and backups.

Run it locally

Local mode stores metadata in SQLite and files on disk. It grants owner access only from the same loopback origin. Running from source requires Node.js 24.12 or newer and pnpm 10.34.3.

git clone https://github.com/plannotator/artifact-server.git
cd artifact-server
pnpm install
pnpm dev

Open the printed URL. Public package download and verification commands will be added on release day. See Get started locally for the current source-development path.

Usage

Most artifacts are published by an agent through the Artifact Server Skill or MCP. For direct access, use the artifactserver CLI to publish files and directories, connect to remote servers, and create new versions. Read the CLI guide.

Security model

Artifact Server serves untrusted artifact content from isolated version hosts, separate from the trusted application origin used for authentication, review, comments, API, and MCP. Private content uses version-scoped browser sessions, and untrusted paths cannot select storage locations.

Read the security model or report a vulnerability.

Read about Artifact Server's software supply-chain security.

Development and project records

Install dependencies and run the focused development checks:

pnpm install
pnpm check
pnpm test:web

Run the complete iteration gate before a handoff:

pnpm verify:iteration

Repository engineering rules live in AGENTS.md.

The project directory contains specifications, conformance evidence, performance records, prototypes, and research. Start with:

Public guides live in the documentation index.

License

Artifact Server is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only), © 2026 backnotprop.


Artifact Server is created with Plannotator      Plannotator Workspaces is the planning layer for your software factory

created by backnotprop

Contributors

backnotprop

311 commits

plannotator/artifact-server

The self-hosted, open-source alternative to Claude Code artifacts.

142

stars

311

commits

TypeScript

primary language

Sep 11, 2026

updated

artifactserver.com
agent-artifacts
ai-artifacts
artifacts
claude-code
codex
opencode
pi

README

Artifact Server

Artifact Server

The open-source, self-hostable alternative to Claude Code artifacts.

Artifact Server gives people and agents one place to publish, review, comment on, version, and share the artifacts they create while building products. Its built-in MCP server gives agents direct access to the same work.

Run it on a laptop for one developer. Deploy it for a private team on Cloudflare, one server, Kubernetes, AWS, or Google Cloud.

Artifact Server is created with Plannotator      Plannotator Workspaces is the planning layer for your software factory

Contents

Why Artifact Server

Teams now use HTML, images, and video for plans, mockups, prototypes, code reviews, and other work created during product development. That work quickly becomes disorganized, and providers try to lock it inside their platforms.

Artifact Server gives teams a self-hosted place to organize and collaborate on that work. Store artifacts by project, share them, comment on them, and keep control of the files and data.

Built for AI agents and team collaboration

Claude    Codex    Cursor    GitHub Copilot    Pi    OpenCode

AI agents connect to Artifact Server through its built-in MCP server    Team members add comments to exact artifact versions

Artifact Server includes a built-in MCP server and a portable Agent Skill. Agents publish and update versioned artifacts. Teams review, comment on, and share the same work.

Connect the agent and install the skill:

artifactserver connect
npx skills add plannotator/artifact-server

Then ask:

/artifact-server upload that HTML design doc

The agent returns the full-screen review link first. Read the MCP guide for source checkouts, remote servers, permissions, and supported operations.

Live session delivery is available from source for Pi and Claude Code Channels. Claude Channels require its research-preview development flag and, on managed plans, the organization policy. The OpenCode adapter is not release-qualified; live-host verification and contributions are welcome.

Artifact Server has native Pi support for live integrated feedback Artifact Server supports live feedback through the Claude Code Channels research preview OpenCode live-host verification, features, and pull requests are welcome

Cloudflare and Artifact Server

Cloudflare is the main hosted deployment target. Cloudflare Artifacts can add private Git-backed history for selected projects. It is off by default and currently requires closed beta access.

Cloudflare Artifacts provides optional Git-backed history

Cloudflare is optional. Artifact Server also runs locally, on Compose, on Kubernetes, on AWS, and on Google Cloud.

Artifact Server supports Cloudflare, Docker Compose, Kubernetes, AWS, and Google Cloud

Deploy it for a team

Every remote deployment uses one trusted application origin and one isolated wildcard content domain.

DeploymentData layerGuide
CloudflareD1 and R2Cloudflare guide
Compact ComposeSQLite and one file volumeCompose guide
External-storage ComposePostgreSQL and S3-compatible storageCompose guide
KubernetesPostgreSQL and object storageHelm guide
AWSECS, RDS, and S3AWS Pulumi guide
Google CloudCloud Run, Cloud SQL, and Cloud StorageGoogle Cloud Pulumi guide

Azure teams deploy through the Helm chart on AKS; there is no separate Azure installer. Azure Blob Storage is available as a preview adapter and has not passed live Azure qualification.

Read the deployment guide for shared requirements, storage choices, authentication, and backups.

Run it locally

Local mode stores metadata in SQLite and files on disk. It grants owner access only from the same loopback origin. Running from source requires Node.js 24.12 or newer and pnpm 10.34.3.

git clone https://github.com/plannotator/artifact-server.git
cd artifact-server
pnpm install
pnpm dev

Open the printed URL. Public package download and verification commands will be added on release day. See Get started locally for the current source-development path.

Usage

Most artifacts are published by an agent through the Artifact Server Skill or MCP. For direct access, use the artifactserver CLI to publish files and directories, connect to remote servers, and create new versions. Read the CLI guide.

Security model

Artifact Server serves untrusted artifact content from isolated version hosts, separate from the trusted application origin used for authentication, review, comments, API, and MCP. Private content uses version-scoped browser sessions, and untrusted paths cannot select storage locations.

Read the security model or report a vulnerability.

Read about Artifact Server's software supply-chain security.

Development and project records

Install dependencies and run the focused development checks:

pnpm install
pnpm check
pnpm test:web

Run the complete iteration gate before a handoff:

pnpm verify:iteration

Repository engineering rules live in AGENTS.md.

The project directory contains specifications, conformance evidence, performance records, prototypes, and research. Start with:

Public guides live in the documentation index.

License

Artifact Server is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only), © 2026 backnotprop.


Artifact Server is created with Plannotator      Plannotator Workspaces is the planning layer for your software factory

created by backnotprop

Contributors

backnotprop

311 commits

Languages

TypeScript

84.3%

HTML

5.1%

CSS

2.5%

Astro

2.3%

Shell

1.9%

MDX

1.8%

JavaScript

1.7%