@markishh/devkit

A portable library of dev-tool helpers (SSH-prod, psql, redis, BullMQ, docker-logs, menu rendering, probe scaffolds) plus a project scaffolder that generates project-specific pnpm dev:* tools.

Born from a 10-day Claude-Code session log review on a single project that showed 80+ manual ssh+docker+psql calls, 25 grep cycles, 15 revalidation loops — all collapsible to one-liners that simply weren't there yet.

Install

pnpm add -D @markishh/devkit
# or use directly:
npx @markishh/devkit init

CLI

devkit init       # First-time setup in a project directory
devkit update     # Re-detect + re-generate (idempotent, won't overwrite custom edits)
devkit status     # What's installed + when was the last run + what changed
devkit mine       # Scan claude-mem session logs for repeated pain → suggest new tools

Library (importing helpers)

import {
  isRemote, psqlRemote, redisRemote, dockerLogs, apiCallRemote,
  outputTable, showHelp, parseArgs, hasFlag,
  renderMenu, runSafetyCheck,
} from '@markishh/devkit';

See helpers/ for the full API.

Tool templates

Project-specific tools generated by devkit init are thin wrappers around library helpers. Templates live in tool-templates/ and are parameterized by detected project facts (container names, queue names, table names, REMOTE_HOST). Edit any generated file freely — devkit update won't overwrite files that diverged from their template signature.

Status

v0.1.0 — Foxet stack (Node + pnpm + Postgres + Redis + BullMQ + SSH-prod). Other stacks land as second projects demand them.

License

MIT