plint

Static hosting on Bunny.net, in one command.

Point it at a folder, get a URL. Works the same for people at a terminal and for AI agents over MCP.

An open-source personal project. Not affiliated with Bunny.net — see the disclaimer.

Website · CLI guide · MCP guide · Releases

$ plint ./dist -p docs --create
✔ Upload complete
Deployed docs (created)
https://<pull-zone>.b-cdn.net
Path: /Users/me/site/dist
42 uploaded, 0 deleted, 0 unchanged · 1834221 bytes · cache purged

plint creates a Bunny storage zone and pull zone for your project, uploads only the files that changed, deletes the ones you removed, and purges the CDN cache. It remembers each project by name, so the next deploy is just plint ./dist -p docs.

Why plint

• Incremental deploys. Files are compared by hash. Unchanged files are skipped and removed files are deleted.

• Hard to leak secrets. .git/, node_modules/, .env*, *.pem and *.key are never uploaded, and no ignore file can re-include them. Hidden files are skipped too. .gitignore and .plintignore (in any folder) are respected on top of that.

• Safe previews. plint estimate shows size, warnings and a rough storage cost with no auth. --dry-run shows the full changeset without touching Bunny or local state.

• Built for scripts and agents. Every command takes --json and writes exactly one envelope to stdout; progress goes to stderr. Errors carry stable codes and a suggested fix.

• Agent-native. plint mcp runs a local MCP server with the same tools the CLI uses.

• Resilient. Concurrent uploads with retries on 408/425/429/5xx and network errors. A failed cache purge never fails the deploy.

Related MCP server: StaticX MCP Server

Install

Requires Node.js 22+.

curl -fsSL https://plint.cloud/install.sh | sh

This installs the latest GitHub Release into ~/.plint/bin.

Quick start

# 1. Save your Bunny API key (or set BUNNY_API_KEY)
plint login

# 2. Check that everything is reachable
plint doctor

# 3. See what would be deployed
plint estimate ./dist

# 4. Deploy (prompts for a project name)
plint ./dist

# 5. Redeploy later by name
plint ./dist -p docs

Commands

Deploy

Manage

System

Destroyed project names are reserved and cannot be reused. See the CLI guide for the full details.

Use it from an AI agent

npx add-mcp "plint mcp"

Then just ask:

“Deploy /Users/me/site/dist to project docs.” “Purge the CDN for docs.” “What plint projects do I have?”

Your client discovers these tools automatically:

plint_estimate · plint_deploy · plint_list · plint_inspect · plint_history · plint_files · plint_purge · plint_destroy · plint_doctor · plint_repair

Over MCP, deploys always need an explicit project and an absolute path, and a new project is created only with create: true. More in the MCP guide.

JSON output

Add --json to any command. You get exactly one envelope on stdout:

{ "ok": true, "command": "list", "data": { }, "next_actions": [] }

{
  "ok": false,
  "command": "doctor",
  "error": {
    "code": "AUTH_MISSING",
    "message": "No API key found. Run `plint login` or set BUNNY_API_KEY."
  },
  "fix": "...",
  "next_actions": []
}

Non-interactive and --json deploys require -p <project>.

Auth

plint looks for your Bunny API key in this order:

1. BUNNY_API_KEY environment variable

2. ~/.plint/config.json (written by plint login)

The key is never accepted as a command-line argument and never logged. Project state lives in ~/.plint/state.json.

Development

npm install
npm test                   # unit tests
npm run test:integration   # real Bunny API (needs .env)
npm run build              # bundle to dist/plint.tar.gz
node src/cli-bin.js --help # run from source

Install a local build:

npm run build
PLINT_RELEASE_URL="file://$(pwd)/dist/plint.tar.gz" sh install.sh
export PATH="$HOME/.plint/bin:$PATH"
plint --json doctor

Disclaimer

plint is an independent, open-source personal project. It is not affiliated with, endorsed by, or sponsored by Bunny.net. "Bunny.net" is used only to describe the service plint works with. You need your own Bunny.net account, and you pay Bunny.net directly for any storage and bandwidth you use.

License

MIT. See LICENSE.