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: null with 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