One questionnaire, one universal skill set
AI assistants are only as good as the context they're given. Payo interviews you about your stack, then writes one universal layout — an AGENTS.md entrypoint plus Agent Skills in .agents/skills/ — that every skills-compatible tool reads. Claude Code and Windsurf get thin shims; nothing is duplicated. The AGENTS.md entrypoint tells the assistant to follow those skills — and you can opt into a change-audit skill that checks your pending change against them before you commit or push.
.claude/skills/
.agents/skills/
.agents/skills/
.agents/skills/
.agents/skills/
.windsurf/skills/
Knows your stack, not just generic advice
Payo understands 30 frameworks, 29 ORMs, and 17 databases across eight languages — backed by a bank of 200+ stack-tailored questions it draws from, asking only the handful your stack needs. Choose Next.js and you get Next.js follow-ups; choose Postgres and you're asked about migrations and naming; pick Tailwind or Clerk and you get provider-specific conventions in the generated rules.
Works on existing projects too
Payo isn't just for empty repos. Run it in an established codebase and it
reads what's already there — package.json, pyproject.toml,
go.mod, Cargo.toml, composer.json, *.csproj, pom.xml, build.gradle, Gemfile, lockfiles, tool configs, and your folder layout — to detect
your stack across TypeScript/JavaScript, Python, Go, Rust, PHP, C#, Java, and Ruby, then pre-fills the questionnaire.
Pick Detect everything and Payo treats your code, folder structure, and git history as the
source of truth — recording exactly what it finds (including your branch-naming and commit conventions) and
skipping anything it can't, with no question-by-question prompts. You land straight on the review screen and confirm.
Monorepos are detected too: it enumerates workspace members (pnpm, Cargo, go.work,
Maven / Gradle…) — including nested workspaces the root never declared, like a Cargo workspace under
services/ — reads each package's stack, and adds a Workspace Packages list plus monorepo conventions
to the generated guidance. Hybrid repos (a React frontend next to a Rust backend) are classified
as one full-stack project, with the extra languages listed alongside the dirs that carry them. The optional
AI pass also reads your README and project docs to fill gaps — never overriding what detection
found. You review a summary and tweak — no typing it all out.
Stop re-explaining your project
Every session starts cold. Your assistant doesn't know you use Drizzle over Prisma, that
handlers live in src/routes, or that commits follow Conventional Commits — so
you re-explain it chat after chat, and still get code that ignores half of it.
Writing the guidance by hand is tedious, so most people never do it. Payo writes it in minutes, in one universal layout every skills-compatible tool reads — so your assistant follows your conventions from the first prompt.
How it works
- Run it in your repo. payo — no signup, no config, no Node.js required.
- Answer a short questionnaire. Questions adapt to your stack; most have sensible defaults.
- Get tailored guidance files. Rich AI-written docs when the tool's CLI is present, solid templates otherwise.
- Optional bootstrap prompt. A paste-ready prompt to scaffold a runnable project honoring the rules.
Understands 30 frameworks, 29 ORMs, and 17 databases across TypeScript/JavaScript, Python, Go, Rust, PHP, C#, Java, and Ruby — from a bank of 200+ stack-tailored questions.
Frequently asked questions
What is a CLAUDE.md file?
A guidance file Claude and Claude Code read to learn your project's stack, conventions, and rules — so the assistant follows them instead of guessing. Payo generates one tailored to your project automatically.
How do I generate Cursor rules?
Install it with the one-liner above, run payo, answer a short questionnaire, and Payo writes universal Agent Skills in .agents/skills/ plus an AGENTS.md — which Cursor reads natively — tailored to your framework, database, testing, and git conventions.
Do I need Node.js or Bun to run Payo?
No. The one-line installer gives you a self-contained binary — no JavaScript runtime at all, which is what makes Payo usable from Rust, Go, C#, Python and Java projects. If you already have Node.js 20.12+ or Bun, the installer quietly uses the smaller npm package instead, and npx @uge/payo still works. Bun is only needed to build from source.
Which AI coding tools does Payo support?
Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, Antigravity, and Gemini — all from one universal layout (AGENTS.md + .agents/skills/), with thin shims for Claude Code and Windsurf.
Does Payo work on an existing project?
Yes. Payo detects your stack from what's already in the repo — manifests (package.json, pyproject.toml, go.mod, Cargo.toml, composer.json, *.csproj, pom.xml, build.gradle, Gemfile), lockfiles, tool configs, and folder layout — across TypeScript/JavaScript, Python, Go, Rust, PHP, C#, Java, and Ruby, then pre-fills the questionnaire. Choose Detect everything and it uses your code, folder structure, and git history as the source of truth — recording what it finds (branch-naming and commit conventions included) and skipping what it can't — so you just review the summary before generating.
Does Payo support monorepos?
Yes. Payo enumerates workspace members across pnpm, npm, yarn, lerna, Cargo, go.work, and Maven / Gradle — including nested workspaces the root never declared, like a Cargo workspace under services/ — detects each package's stack, and merges the real app stack with the root's shared tooling (package manager, runtime, formatter, test runner). Hybrid repos mixing a frontend and a backend language are classified as one full-stack project, with the extra languages listed. The generated AGENTS.md adds a Workspace Packages list naming each member and its stack, plus monorepo conventions.
Can Payo audit my changes against the project rules?
Yes, optionally. Opt into the change-audit skill during the questionnaire and pick when it runs — before every commit or before pushing. At that point your assistant reads the pending change, selects only the relevant project skills, and reports anything that conflicts. To make sure it fires, Payo also writes a native PreToolUse hook for Claude, Cursor, and Copilot that pops a confirm prompt right when the agent runs git commit / git push. The generated AGENTS.md also tells the assistant to consult and follow the applicable skills before writing code.
Does Payo add safety guardrails for databases and secrets?
Yes. Payo asks whether the assistant must get explicit confirmation before running destructive SQL or database migrations, and whether to add a gitleaks secret-scan convention that scans for leaked secrets before every push. Beyond the skills, Payo writes the hooks that enforce them: a lefthook git hook — or a merge into your existing husky / pre-commit / native hooks — that runs gitleaks and your tests and hard-blocks the commit or push on failure, plus a native confirm prompt before destructive SQL for Claude, Cursor, and Copilot. Payo writes the config and tells you to run lefthook install once; it installs no tools itself. Both are recommended on and applied in Detect everything.
Is Payo free and open source?
Yes. MIT-licensed and free. Source on GitHub.