git404hub

what is pinkypromise fr?

alesimula/pinkypromise — explained in plain English

Analysis updated 2026-05-18

0Audience · developerComplexity · 1/5LicenseSetup · easy

tl;dr

A playful plugin that has an AI coding agent pinky swear to follow a rule for the rest of a session, with humorous levels of seriousness.

vibe map

mindmap
  root((pinkypromise))
    What it does
      Agent swears to a rule
      Holds for the session
      Needs mutual unlock
    Tech stack
      Claude Code plugin
      Skill file
    Use cases
      Protect a database schema
      Guard against risky edits
      Undo a prior promise
    Audience
      Claude Code users
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask an AI agent to promise it will never touch a database schema during a session

VIBE 2

Set a strong level of promise for a rule you really care about, like avoiding hidden vulnerabilities

VIBE 3

Undo a previous promise using a matching unlock phrase the agent agrees to

VIBE 4

Add the same rule enforcement idea to any AI agent that supports skill files

what's the stack?

Claude Code PluginMarkdown Skill

how it stacks up fr

alesimula/pinkypromise00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity1/52/53/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Installs as a Claude Code plugin marketplace, or as a single skill file for other agents.

Use, modify, and share this freely without restriction.

in plain english

pinkypromise is a playful add-on for AI coding agents that turns a rule into something closer to a spoken promise than a written policy. Instead of writing a rule into a config file, you ask your agent to pinky swear that it will follow it, such as never touching a database schema during a session. The agent can accept or decline the swear, but once it agrees, the idea is that it should stick to that rule for the rest of the session without quietly backing away from it. The tool defines a few levels of how seriously the promise is meant to be taken, from a light gentleman's agreement up to a stronger version meant for rules the user really cares about. A swear can only be undone through a matching unlock phrase, and even then the agent has to agree to dissolve it, so ending a promise is treated the same way as making one, as a two sided exchange rather than a simple command. The README frames the whole idea with humor, describing the pinky swear in playful, exaggerated language, while also including a more serious sounding passage that calls it a binding security commitment. Readers should treat that framing as part of the joke rather than an actual technical guarantee, since nothing in the project changes how an AI model is restricted at a lower level. Installing it for Claude Code works through the plugin and marketplace system built into the tool, since the repository ships its own marketplace file. For other AI agents, the entire behavior lives in a single skill file that can be added by hand however that agent loads skills. The project is released with permissive, informally worded terms that amount to letting anyone use, modify, or share it freely.

prompts (copy fr)

prompt 1
Install the pinkypromise plugin marketplace and add it to my Claude Code setup
prompt 2
Have my agent pinky promise full to never delete a file without asking first
prompt 3
Show me the SKILL.md file so I can add pinkypromise to a non-Claude agent
prompt 4
Explain the difference between the lite, full, and ultra pinky promise levels

Frequently asked questions

what is pinkypromise fr?

A playful plugin that has an AI coding agent pinky swear to follow a rule for the rest of a session, with humorous levels of seriousness.

What license does pinkypromise use?

Use, modify, and share this freely without restriction.

How hard is pinkypromise to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pinkypromise for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.