# Rychlý start (https://docs.vitrinka.ai/cs/start/quickstart)



## Server, se kterým mluvit [#server]

Všechno níže potřebuje nasazení: workspace na `app.vitrinka.ai`, nebo vlastní stroj — [instalace na vlastním hostiteli](/cs/operator/install) je jeden Compose soubor. CLI i rekordéry fungují proti oběma úplně stejně.

## Založte si účet [#account]

Ještě nemáte účet? Zaregistrujte se na [app.vitrinka.ai/auth/signup](https://app.vitrinka.ai/auth/signup) — beta je otevřená, účet vznikne na místě a odkazuje na ni i [přihlašovací stránka](https://app.vitrinka.ai/auth/login). Na vlastním hostu vytvoří vaše první přihlášení účet, jeho organizaci a první workspace.

## Instalace a nastavení [#install]

Z repozitáře, ve kterém pracujete:

```bash
npm i -g @vitrinka/cli
vitrinka setup
```

Jedna instalace pro macOS, Linux i Windows. `vitrinka setup` přihlásí tento stroj schválením v prohlížeči — nikdy vloženým secretem — a uloží zapisovací token, který přihlášení vydá, nainstaluje plugin pro Claude Code / Codex se skilly z veřejného marketplace `vitrinka-kit`, zaregistruje MCP (HTTP položku bez tajemství, která se přihlašuje přes OAuth), naváže tento checkout na jeho projekt v commitovaném `vitrinka.config.json`, přidá agentní hooky a — pokud přijmete — rozšíření rekordéru do prohlížeče. Přepínače a na co se ptá: [instalace CLI](/cs/dev/cli/install).

## Vyberte workspace [#bind]

Patříte do víc než jednoho workspace? Navažte tento repozitář na ten, kam mají mířit jeho zápisy:

```bash
vitrinka config bind acme --project myapp
```

Navázání říká každému budoucímu příkazu — a každé agentní session v tomto repozitáři — do kterého workspace a projektu patří.

## Dostaňte něco na nástěnku [#capture]

Nejrychlejší první nástěnka je upload:

```bash
vitrinka board init                              # jednou na repozitář — pojmenuje set a vypíše jeho kořen
vitrinka board capture web --file shot.png --route /home --note "Domů"  # přidá screenshot do setu
vitrinka board push                              # publikuje set na server
vitrinka board create --title "První nástěnka" # naimportuje set — vypíše URL nástěnky
```

Další soubory později míří přímo na nástěnku: `vitrinka board upload ./next.png --board <slug>`.

Nebo to nechte na agentovi: řekněte „publikuj to", zatímco staví UI, a [capture skilly](/cs/dev/skills/overview) práci nasnímkují a vrátí URL nástěnky. Nahrání celé ruční testovací cesty je [rekordér v prohlížeči](/cs/qa/extension).

## Anotujte [#annotate]

Otevřete URL nástěnky. Nakreslete oblast na tom, co je špatně, a napište jednu větu. To je celé hlášení — obrazovka, oblast i větev už jsou připojené.

## Sledujte, jak se to opraví [#fix]

V repozitáři aplikace běží agentní session s `/vitrinka:listen`. Každá anotace ji probudí: opraví kód, pověsí snímek po opravě vedle vaší oblasti a odpoví ve vlákně. Opravu přijmete na nástěnce.

<Callout type="warn">
  Listener běží v repozitáři, který vlastní kód, ne tam, kde zrovna jste — anotace se stávají pracovními položkami vázanými na ten projekt a větev.
</Callout>

## Kam dál [#next]

* [SaaS nebo self-hosted](/cs/start/deployments) — které nasazení sedí.
* [QA a testování](/cs/qa) — nahrávání místo hlášení.
* [Vývojář](/cs/dev) — CLI, MCP a skilly do hloubky.