Get started locally

The local target runs directly on the host with SQLite, local blob storage, and loopback-only content origins. The loopback application gives the local owner browser access without a sign-in form. The source installation requires Node.js 24.12 or newer and pnpm 10.34.3.

Run from source

Install dependencies

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

Start Artifact Server

pnpm dev

Open the printed URL. pnpm dev starts both the web application and API. Do not run artifactserver open as a second setup step. Run CLI commands from the checkout with pnpm artifactserver <command>.

Publish from an agent

Connect the agent to the running development installation:

pnpm artifactserver connect --data .artifact-server

Then install the Artifact Server skill:

npx skills add plannotator/artifact-server

Then ask the agent to upload the finished file. In clients that expose skills as slash commands:

/artifact-server upload that HTML design doc

The agent returns the full-screen review link first.

Local access behavior

Requests from the loopback application origin can obtain the local-owner session without a sign-in form. Remote access still requires authentication. Hosted and private-team deployments use their selected identity provider.

Run from source

Local access behavior

Next