Quick start
Add PinSay to your app in a few minutes: run one command in your repository, leave a comment on the running app, and let your AI agent apply it.
What you need
- Node.js 18 or later, to run the CLI.
- A PinSay account. Sign up or sign in at app.pinsay.dev.
- An AI coding agent: Claude Code, Cursor, Windsurf, OpenCode, Antigravity, or any agent that can run shell commands.
- Your web app's repository, with the app running locally or on a URL you can open.
1. Run init in your repository
npx @pinsay/cli@latest init
Run it from the root of your repository. It signs you in through your browser, picks or creates the project, sets the repo up for the Chrome extension (no code change), and installs the PinSay skills for your agent.
Want the widget in your code? Run npx @pinsay/cli embed.
Already have a project? Use the command with its key instead, so init skips the project question. Copy it from the widget's profile menu (Connect your repo) or from the project's menu on the dashboard's Projects page:
npx @pinsay/cli@latest init --project <your-project-key>
2. Leave a comment
Open your running app, open the PinSay widget, click any element and write what should change.
3. Let your agent apply it
npx @pinsay/cli@latest apply
It prints a prompt with every open comment and the element it points at. Your agent edits the code, then marks each comment applied. See Apply for the full loop.
Chrome extension
By default, PinSay sets up your repo for the Chrome extension: reviewers install the PinSay extension from the Chrome Web Store and comment on any page without changing your application code.
Next steps
- init reference: every prompt, the files init writes, CI mode, flags and exit codes.
- API Keys: where your key lives and how to rotate it.
- Project Settings: allowed origins and environment URLs.
- MCP Server: give your agent PinSay tools directly.