Docs
Ship your first agent in 10 minutes
A happy-path walkthrough: sign up, claim your username, become a builder, draft a Tier-1 manifest with AI help, and submit for review.
On this page
This walkthrough takes you from a blank account to a live, reviewable Tier-1 agent. Tier-1 agents are manifest-only — no code, fully self-serve in the browser.
Step 1 — Sign up
Visit /sign-up and create your account. moulds.ai uses Clerk for auth, so you can sign in with Google or an email + password.
Step 2 — Claim your username
Head to /me/profile and pick a username (3–30 characters, lowercase letters,
digits, hyphens, and underscores only). Once you save it, your public profile is live at
/u/<username>. It'll be empty until you publish an agent — that's next.
Step 3 — Become a builder
Still on /me/profile, click Become a builder → and confirm on the next page. You now have access to the builder dashboard at /dashboard, including /dashboard/apps (your agents) and /dashboard/apps/new (the creation wizard).
Step 4 — Describe your agent with AI
Open /dashboard/apps/new. On the right-hand side is an AI side-panel that asks you to describe your agent in plain English. Try something like:
- "Take a contract PDF and extract the key clauses and any red-flag terms."
- "Classify the sentiment of customer reviews from a CSV upload."
The AI returns a starter manifest in the editor, plus a notes paragraph explaining
the choices it made. Click Replace editor with this draft to load it into the YAML
editor, then refine any field — the slug, the prompt template, the output schema,
pricing, whatever you need.
Heads-up: If the AI decides your idea needs cron, OAuth, multiple HTTP routes, or custom UI, it returns
manifest: nullwith an explanation pointing you at Tier-2. That is the right call — see Tier-1 vs Tier-2.
Step 5 — Create the agent and save your app key
Click Create agent. The platform validates the manifest, inserts the agent row, and mints a one-time app key — copy and save it now, it is only shown once. The key identifies your agent in server-to-server calls.
Step 6 — Test it before it goes public
The toolbar shows a Preview at /u link. Click it to open your agent at
/u/<username>/<slug>. Your agent is fully runnable here immediately after creation —
no admin approval needed. Share this URL with teammates or beta testers to try it out.
Step 7 — Submit for review
When you're happy with it, click Submit for review. An admin will either:
- Approve → your agent appears in the public catalog at
/agents/<slug>. - Reject → you'll see the rejection reason in /dashboard/apps. Iterate and resubmit.
Need code, cron, or integrations? → Tier-1 vs Tier-2