DEDUPED Hot AI repos, turned into use cases Get the Monday 5
267 stars · TypeScript

How to use Frog: what you can do with it

What is Frog? Frog is a TypeScript command line tool that lets AI agents record friction they hit as committed entries, report them as GitHub issues, and remove them once resolved.

How do I use it? Run npm install -g frog or use the standalone installer from the README; then run frog init in the repository to create the friction log, config, and issue form; run frog log --publish so the entry is reported as an issue immediately. Full steps below.

Trended earlier

View repo on GitHub

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer

What do you want to do?

4 use cases

  • Log agent friction and report it as a GitHub issue

    Record a friction entry in the repo so the next agent reads it and an owner gets an issue.

    View prompt
    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.

  • Report friction in a dependency to its maintainers

    Send a friction entry to an upstream project that has opted in, using its issue form.

    View prompt
    In the frog repository, run `frog targets` and then `frog log --target <package>` for the dependency that caused the friction. Expected output: a targeted entry scaffolded from that project's issue form. Verify by running `frog list` and checking that the entry shows the target package.

  • Share one friction log across agents in PostgreSQL

    Store friction entries in a shared PostgreSQL database that several agents can read and write.

    View prompt
    In the frog repository, set FROG_DATABASE_URL to the team's PostgreSQL connection string, run `frog migrate`, then `frog list`. Expected output: the store is created or upgraded and the list shows entries from the shared database. Verify that the list command exits without error.

  • Accept friction reports from other repositories

    Turn on inbound reports so other repositories can send friction to your project.

    View prompt
    In the frog repository, run `frog init`, then open .agents/friction-log/config.json and confirm the inbound setting is enabled. Expected output: a config file with inbound.enabled set to true. Verify by reading that file and running `frog list` without errors.

Quick start with Frog

  1. Check you have what it needs: 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.
  2. Open wevm/frog on GitHub and read the README and license.
  3. Run npm install -g frog or use the standalone installer from the README.
  4. Run frog init in the repository to create the friction log, config, and issue form.
  5. Run frog log --publish so the entry is reported as an issue immediately. (inferred, check the README)
  6. Run frog list to confirm the entry is listed and shows that it has been reported.

These steps come from our top use case, Log agent friction and report it as a GitHub issue, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for wevm/frog

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Frog alternatives · Best AI repos for Software and DevOps

About this repo

  • Who it is forDevelopers and teams whose AI agents keep hitting the same friction in their repositories or dependencies and need that friction recorded and owned.
  • Why it is hot267 stars
  • LanguageTypeScript
  • Sourcegithub.com/wevm/frog · Back to Hot repos

Requirements

  • 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

Add this badge to your README

Maintain Frog? Show readers where to find these use cases. Use cases on Deduped

Markdown 

[![Use cases on Deduped](https://dedupedai.com/badge/wevm/frog.svg)](https://dedupedai.com/use-cases/wevm-frog/?utm_source=github&utm_medium=badge&utm_campaign=wevm-frog)

HTML 

<a href="https://dedupedai.com/use-cases/wevm-frog/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=wevm-frog"><img src="https://dedupedai.com/badge/wevm/frog.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Frog

What is Frog?

Frog is a TypeScript command line tool that lets AI agents record friction they hit as committed entries, report them as GitHub issues, and remove them once resolved. It is an open-source project on GitHub: https://github.com/wevm/frog.

How do I use Frog?

Run npm install -g frog or use the standalone installer from the README; then run frog init in the repository to create the friction log, config, and issue form; run frog log --publish so the entry is reported as an issue immediately. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Frog for?

Developers and teams whose AI agents keep hitting the same friction in their repositories or dependencies and need that friction recorded and owned.

What can I do with Frog?

4 use cases so far, for example: Log agent friction and report it as a GitHub issue; Report friction in a dependency to its maintainers; Share one friction log across agents in PostgreSQL. Each has steps and a copy-paste agent prompt.

What do I need to run Frog?

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.

What are alternatives to Frog?

Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.

Is Frog safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.