Getting started with Specnote
How to confirm your app behaves as planned without reading code. New here? Start from Getting started and read in order.
Browse the docs
- Key terms at a glanceAs you use Specnote, you'll run into a handful of terms — project, area, scenario, step, verification, credits. Here they are, explained in plain language. Come back whenever something is unclear.
- How verification worksYou're probably wondering what "the AI tries it out for you" actually means. Here's how a real browser replays your scenario, how pass and fail are decided, and how the results are saved.
- Four ways to create scenariosThere are four ways to turn what you want to check into a scenario: pull them from your code, build them through a chat with AI, get walk-through suggestions, or write them yourself. Pick the one that fits your situation.
- Running verification and reading resultsOnce your scenarios are ready, it's time to run verification. Learn how to run it, how to read the pass and fail results, and how to get a fix report and hand it to your AI when something breaks.
- Connect your code (MCP)Specnote's most powerful trait is that it can reach your actual code directly. We'll walk you through connecting AI tools like Claude Code, and how we keep your production secrets from being stored on our servers.
- Credits and plansScenarios are unlimited, and you only spend credits when you need verification. Here's everything in one place — what a credit is, how much each task costs, and how plans, top-ups, and refunds work.
- Frequently asked questionsWe've gathered the questions new users ask most. Quickly check whether you need to know code, whether your data is safe, what to do when something goes wrong, and more.
- Connect CI for automatic verificationHere's how to make verification run on its own every time you push code. One paste to your AI is all it takes to connect, and results land on both GitHub and the test-run tab. We also cover connecting it by hand and the questions people ask most.
- What is SpecnoteWithout reading code yourself, Specnote confirms whether the app you (or your AI) built behaves the way you planned — by clicking through it like a real person. Let's start with what problem it solves and who it's for.
- Get your first verification in 5 minutesFollow the first steps from signing up to getting your first verification result — all in under five minutes. You'll create a project, describe a scenario in plain words, and get back the result of the AI clicking through it for you.
Want to try it right away?
In five minutes you can build your first scenario and get a verification report.