Credentials. The connection string grants database access, so keep it in an environment variable or secret store and do not commit it to the repository.
Who it is forA team running several agents or applications that need to record and inspect the same friction history.
The problemA friction log kept in one repository's files is hard for several agents and applications to record to and inspect together.
The outcomeFriction entries stored in a shared PostgreSQL database, listed from the same command for every agent that connects.
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
- Set your PostgreSQL connection string with
export FROG_DATABASE_URL=postgres://..., replacing the placeholder with your own value. - Run
frog migrateto create or upgrade the selected store. - Run
frog listto confirm the agents can read the shared entries. - Point each agent or application at the same connection string through its own configuration, using the Store.postgres({ connectionString }) factory from the README. (inferred, check the README)
Prompt for your agent
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.
Caveat. The README lists PostgreSQL as the only available database, with SQLite and Cloudflare D1 marked as coming soon.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for wevm/frog and "Share one friction log across agents in PostgreSQL"
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