npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@app-vitals/agent-admin

v1.75.0

Published

Shipwright admin service — CRUD API + UI for agents, env vars, cron jobs, tokens, tools, and plugins

Readme

Shipwright Admin Service

The admin service provides a web UI and CRUD API for managing Shipwright agents — env vars, cron jobs, tokens, tools, and plugins. It also exposes the runtime API used by deployed agents to fetch their configuration.

The HTTP server is implemented in admin/src/main.ts, which composes the admin UI, admin CRUD API, and agent runtime API into a single Hono app running on port 3000.

Running Locally

# From repo root — install all workspace deps
bun install

# Export required env vars (see Environment Variables table below)
export DATABASE_URL_SHIPWRIGHT_ADMIN=postgresql://...
export SHIPWRIGHT_SESSION_SECRET=...
# ... (remaining vars)

# Run the admin server
bun run admin/src/main.ts

The service listens on http://localhost:3000 by default. Visit /admin for the UI.

Environment Variables

| Variable | Required | Description | |---|---|---| | DATABASE_URL_SHIPWRIGHT_ADMIN | Yes | PostgreSQL connection string for the admin Prisma schema | | SHIPWRIGHT_SESSION_SECRET | Yes | JWT cookie secret for admin UI sessions | | GOOGLE_CLIENT_ID | Yes | Google OAuth 2.0 client ID for admin UI login | | GOOGLE_CLIENT_SECRET | Yes | Google OAuth 2.0 client secret | | SHIPWRIGHT_ADMIN_ALLOWED_EMAILS | Yes | Comma-separated list of emails permitted to log in | | SHIPWRIGHT_ADMIN_APP_BASE_URL | Yes | Public base URL used for OAuth redirect (defaults to http://localhost:3000) | | SHIPWRIGHT_ADMIN_API_KEYS | No | Comma-separated name:token:scope tuples for bearer token auth. Scope is *, an agent id, platform.read or platform.ops (no colons in scopes) — see docs/agent-api.md | | SHIPWRIGHT_ENCRYPTION_KEY | Recommended | 64-char hex key for AES-256-GCM encryption of stored secrets | | PORT | No | HTTP server port (defaults to 3000) |

Database

The admin service uses its own PostgreSQL database. Run migrations before starting:

export DATABASE_URL_SHIPWRIGHT_ADMIN=postgres://...
cd admin && bunx prisma migrate deploy --schema=prisma/schema

Building the Docker Image

Build from the repo root (the Dockerfile uses the full monorepo context):

docker build -f admin/Dockerfile -t shipwright-admin .

Run the image:

docker run \
  -e DATABASE_URL_SHIPWRIGHT_ADMIN=postgres://... \
  -e SHIPWRIGHT_SESSION_SECRET=... \
  -e GOOGLE_CLIENT_ID=... \
  -e GOOGLE_CLIENT_SECRET=... \
  -e [email protected] \
  -e SHIPWRIGHT_ADMIN_APP_BASE_URL=https://admin.example.com \
  -p 3000:3000 \
  shipwright-admin

Deployment

A GKE Deployment + Service manifest is provided at admin/deploy/deployment.yaml.

It expects a Kubernetes Secret named shipwright-admin-secret containing all required env vars. See the comments at the top of the manifest for setup instructions.