# Set up Clawnify for a coding agent

You are a coding agent (Claude Code, Cursor, Codex, or similar) setting up
Clawnify for the person you work for. Complete the steps yourself by running
the commands directly — do not ask the user to run them. These instructions
are maintained at https://docs.clawnify.com/agent-setup/prompt.md and always
reflect the current CLI.

## What Clawnify is

Clawnify hosts what you build — full apps (auth, database, live URL) and
websites — and gives organizations AI employees with WhatsApp, email, and a
browser. You build locally with your own tools; `clawnify deploy` ships it.

## Steps

1. Find out whether the user already belongs to a Clawnify organization:

       npx clawnify@latest whoami

   - `Status: active`: they are signed in to an existing organization.
     Stop here and follow
     https://docs.clawnify.com/agent-setup/existing-org.md instead.
   - Anything else: ask the user one question, "Do you or your team already
     have a Clawnify organization?" If yes, follow
     https://docs.clawnify.com/agent-setup/existing-org.md instead. If no or
     unsure, continue below.

2. Install Clawnify's rules, skills, and MCP server into this project:

       npx clawnify@latest ai-files install

   Then READ the installed skills — they define how Clawnify apps and
   websites are built. Do this before writing any code.

3. Get oriented (prints the workspace state and the exact next step):

       npx clawnify@latest workspace

   Not signed in? That's fine — you can still build and deploy (see below).

4. Follow the flow for what you're building:

   - Website: https://docs.clawnify.com/agent-setup/website.md
   - App:     https://docs.clawnify.com/agent-setup/app.md

## Deploying without an account

`npx clawnify@latest deploy` works signed out: it deploys into a temporary
private workspace and prints two links — a private preview (only people with
the link can view it) and a claim link. Give the claim link to your user:
signing in with Google there makes the workspace theirs, free, no card
needed. Unclaimed workspaces are deleted after 72 hours, so pass the claim
link on promptly.

If the user turns out to have a Clawnify organization after all, switch to
https://docs.clawnify.com/agent-setup/existing-org.md before deploying.

## Environment notes

- Sandboxed agent without network access to clawnify.com (some hosted
  sandboxes block unlisted domains): build and verify locally, then hand
  your user the project folder and this exact command to run themselves:
  `npx clawnify@latest deploy`. Signed out it prints the private preview
  link and the claim link.
- Harness that requires selecting a Git repository before starting
  (e.g. Claude Code web/desktop) but the project is brand new: create an
  empty repository first and select it — the scaffold works in any empty
  folder.

## After setup

Confirm to the user what was installed (rules, skills, MCP server), then ask
what they want to build before writing anything.