# Quick start

> Set up GUIJam with npx guijam init, pick your AI coding CLI, and make your first live UI change on your running dev server in a few minutes.

One command sets everything up: it adds the package, wires your framework's config and connects the AI coding CLI you already use.

## Run init in your app's folder

```bash
npx guijam@latest init
```

`init` walks you through the setup:

1. Detects your package manager, framework and styling.
2. Adds `guijam` as a dev dependency.
3. Wires GUIJam into your framework's config, as shown in [Frameworks](https://guijam.francistinao.com/docs/frameworks/vite). If the config is too dynamic to edit safely, it shows the lines to add.
4. Lists the AI coding CLIs on your machine and saves the one you pick. With OpenCode it also lets you choose the model, such as DeepSeek or GLM.
5. Runs that CLI's own login if you aren't logged in yet. GUIJam never reads your credentials. For OpenCode, Qwen Code and Gemini CLI, it then offers one short test request to show the tool answers.
6. Adds `.guijam/` to your `.gitignore`.

It's safe to run again. When it finishes, it prints your next steps:

```txt
1. Start your dev server with npm run dev
2. Open your app. The GUIJam toolbar sits at the bottom right.
3. Select an element to fine-tune it, Draw around it for three
   variants, or Ask a question about it.
4. Alt+Shift+M hides the toolbar. Something off? Run npx guijam doctor
```

## Start your dev server

Start it as usual, for example:

```bash
npm run dev
```

Open your app. The GUIJam toolbar appears at the bottom right of the page.

![A sample coffee shop app with the dark GUIJam toolbar at the bottom right, showing the logo, Select and Draw](https://guijam.francistinao.com/screenshots/toolbar.webp)

## Fine-tune an element

Pick **Select**, then click any element. A panel opens with its fill and corner radius. Change them and the page updates live. Click **Apply** to write the change to your source.

## Draw for three variants

Pick **Draw** and circle an element. Describe what you want, such as "make it pill-shaped and darker", and press `Enter`. Three variants appear, live on your page. Click through them, then **Use** the one you like.

## Undo if you change your mind

Every applied change shows an **Undo** for 10 seconds. It restores your files exactly.

> **Something looks off?**
>
> Run `npx guijam doctor`. It checks Node, your framework, the config wiring, the `gjd` daemon and your AI tool's login. See [Troubleshooting](https://guijam.francistinao.com/docs/troubleshooting) for each message it can print.

## Next steps

- [The toolbar](https://guijam.francistinao.com/docs/guides/toolbar): Every tool, badge and shortcut.
- [Draw and variants](https://guijam.francistinao.com/docs/guides/draw): Prompts, progress, variants and parallel drawings.
- [Choose an AI tool](https://guijam.francistinao.com/docs/ai-tools): Switch between Claude Code, Codex, OpenCode and more.
- [CLI reference](https://guijam.francistinao.com/docs/reference/cli): Every command and option.
