Pretty

Getting Started

Pretty is an AI agent for designers that runs in your terminal. Install it, authenticate, and you're ready to generate images, process media, and work with your brand — all from the command line.

Install

Run the install script to download the latest Pretty binary for your platform:

curl -fsSL https://dl.prettydraft.com/install.sh | sh

This installs the pretty binary to ~/.local/bin. Make sure it's in your PATH.

Verify the installation:

pretty version

Authenticate

Pretty uses your prettydraft.com account for authentication. Run the login command to authenticate via your browser:

pretty login

This opens a browser window where you sign in (or create an account). Once authorized, your credentials are saved to ~/.pretty/credentials.json.

For CI environments or headless setups, use a token directly:

pretty login --token pd_sk_your_api_key

Check your auth status anytime:

pretty status

First prompt

The simplest way to use Pretty is to pass a prompt directly:

pretty "Design a logo for a coffee shop called Ember"

This starts an interactive session where the agent reads your prompt, generates images, and saves them to an output/ directory in your current folder.

For a one-shot generation (no interactive follow-up):

pretty -p "Create a social media banner for a tech conference"

What happened

When you ran that prompt, Pretty:

  1. Read your project context. If a DESIGN.md file exists in the current directory, it was loaded as brand context (colors, fonts, style direction).
  2. Scanned for assets. It looked for brand/, references/, and other conventional directories to use as visual context.
  3. Called the AI model. Your prompt, plus all that context, was sent to the image generation model.
  4. Saved the output. Generated files are saved to the output directory with descriptive names.

Interactive mode

Run pretty with no arguments to start an interactive session:

pretty

In interactive mode you can have a multi-turn conversation with the agent, iterate on designs, reference files with @filename, and use slash commands like /help, /model, and /context.

Next steps