# Create and showcase a project

Record your coding sessions, publish a project page and share what you built.

You make a project, record the prompts you type, and send the project for review. It takes about 20 minutes, plus the time of the review.

## Before you start

- Install the Liquid CLI and run `liquid login --projects`. See [Liquid CLI](https://inference.ai.exchange/docs/cli.md).
- Use a workspace with a balance. Only an owner or an admin can submit a project.
- Have a folder where you build with a coding agent, such as `liquid claude`.

## Steps

1. Open **Projects** in the console and select **New project**.
2. Fill in **Name** and **One line about it**. Add **Link to the live project** if you have one.
3. Select **Create project**. The project starts as **Draft**. Only your workspace can see it.
4. Open the **Record from your terminal** card. In your project folder, run the command that it shows:

   ```bash
   liquid project link <slug> && liquid record --prompts
   ```

5. Read the notice. Type `yes` to give consent. A script or a coding agent cannot give it.
6. Start your tool, for example `liquid claude`. Work as usual. Each call counts toward the project, and each prompt that you type goes to a queue on your computer.
7. Run `liquid record review`. For each prompt, keep it, drop it, redact it or mark it public. A prompt that looks like a secret is held until you keep or redact it.
8. Run `liquid record publish`. The command lists what it sends and asks you to type `yes`. The exchange stores each prompt encrypted. A prompt is private unless you marked it public.
9. In the console, open the project. Under **Story and what visitors see**, write your story. Choose which totals visitors see.
10. Select **Submit for review**. The state changes to **In review**. An operator checks the page, which takes about two days.

## Check it works

- `liquid record status` shows that recording is on and how many prompts wait.
- The **Prompt history** card lists your uploaded prompts, and says how many are public.
- After approval, the state is **On show**. Select **Open the public page** to see what visitors see.

## Change a project that is on show

A change to anything that visitors see moves the project from **On show** back to **In review**. Examples are the story, a **Make public** choice and a new public prompt. The page leaves the gallery until an operator approves it again. While a project is in review, you cannot edit it. Select **Withdraw** first.

## If something goes wrong

- **Upload refused with `prompt_consent_required`.** Run `liquid record --prompts` and type `yes`.
- **The CLI says your token cannot change a project.** Run `liquid login --projects`.
- **A prompt does not upload.** The job must belong to your workspace and carry the cost tag of the project. Check `liquid project show`.

## Next steps

- [Data handling](https://inference.ai.exchange/docs/data-handling.md): how long the exchange keeps your prompts and how to delete them.
- [API keys](https://inference.ai.exchange/docs/keys.md): limit what a key can spend.
- [Liquid CLI](https://inference.ai.exchange/docs/cli.md): the other commands of `liquid`.
