Skip to Content
Overview

pf (pulpfixer)

pf is one command line for every repo, in any language. Run pf in a repo to get its menu, and use the same short commands everywhere: pf dev, pf build, pf test, pf docs, pf ver, pf deploy staging. pf works out what each one means in the repo you are in.

pf # menu for this repo pf dev # run the app locally (any language) pf docs # run the repo's docs site pf ver # versions and bumps pf agent # a coding agent with pf's tools

Every invocation prints a banner with its version (pf v4.39) on stderr, so stdout stays pipeable.

Install

npm install -g pulpfixer --registry https://cellars.staging.pangenea.com/ && pf setup

Needs Node >= 18 and npm, no token. See Getting started for the other ways.

Features

FeatureWhat it gives youRead more
Unified commandsdev, build, test, lint, install resolved per repo, from pulpfixer.json, the repo’s own scripts, or a stack defaultCommands
Many stacksNode, Python, Go, Rust, Java, .NET, Ruby, PHP, Elixir, Swift, Docker Compose, and a repo’s own ./a CLIStacks
Docspf docs starts whatever docs site the repo has (Nextra, Docusaurus, VitePress, Starlight, mkdocs, Sphinx, mdBook, Hugo)Run and build
VersioningMajor.minor versions per module and for the stack, with ready-to-run bump commandspf ver
DeploysAuto-detected staging deploys, and a production deploy that only runs what the repo defines and always asksDeploy and publish
SkillsAgent skills found in your skill folders or installed from the registrySkills
AgentClaude Code, Codex or Cursor with pf’s tools, and scoped, read-only, approved AWS accessAgent
PluginsBuilt-in AWS and YubiKey plugins, plus registry plugins you installPlugins
Host modepf on EC2 instances: security patching and a fix agent with no shellHost mode

Principles

  • No third-party runtime dependencies. Colors, the picker and argument parsing are hand-written.
  • Dry runs. Commands that run something support --dry-run.
  • Safe by default. Production is never guessed, and always asks. The agent and MCP tools deploy to staging only.
  • No secrets in pf. pf never reads, prints or writes a registry token. The agent never receives AWS credentials.
  • Works without a terminal. Menus and prompts fall back to static output without a TTY, and colors follow NO_COLOR and FORCE_COLOR.

Where to start

Last updated on