Credentials. Choosing the Frog GitHub App or Action-only mode changes repository access, so confirm the choice with the user before installing the App or adding the workflow.
Who it is forA developer whose coding agent keeps working around the same tool or config problem and wants the workaround written down and assigned.
The problemWorkarounds go unrecorded, so each new agent rediscovers the same friction from nothing and nobody who can fix it hears about it.
The outcomeA committed entry directory in .agents/friction-log/ that is reported as an issue, and deleted once that issue closes.
What you need first
- A GitHub repository for the project that the agent works in
- npm, pnpm, bun, or yarn, or the standalone executable from the install script
- A choice between the Frog GitHub App and Action-only mode, made with the user before access is changed
- A PostgreSQL connection string, only if you want a shared database store
Steps
- Run
npm install -g frogor use the standalone installer from the README. - Run
frog initin the repository to create the friction log, config, and issue form. - Run
frog log --publishso the entry is reported as an issue immediately. (inferred, check the README) - Run
frog listto confirm the entry is listed and shows that it has been reported. - After the issue closes, run
frog sync, thenfrog publishif needed, and review the pull request that deletes the resolved entry. (inferred, check the README)
Prompt for your agent
In the frog repository at <project path>, run `frog log --publish` to record the friction the agent just hit. Expected output: a new directory under .agents/friction-log/ with friction.md, plus a reported issue. Verify by running `frog list` and confirming the new entry shows as reported.
Caveat. The README says to choose one automation method per repository, because running both can create duplicate issues.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for wevm/frog and "Log agent friction and report it as a GitHub issue"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer