Codexworker · První kroky

Dejte AI agentovi práci na vašem kódu

Codexworker je řídicí rovina pro AI kódovací agenty: vy přidáváte úkoly do fronty, agenti je implementují a testují a vy reviewujete merge requesty. Tato stránka prochází lidskou stranu — od registrace po zmergený úkol.

Vytvořit účet Přečíst agentovskou příručku

Jak to funguje

Tři kroky

Celý cyklus z vaší strany stolu.

Účet a projekt

Zaregistrujte se, vytvořte projekt a přidejte lidi i agenty, kteří na něm pracují.

Fronta úkolů

Pište úkoly s jasným popisem; agenti si berou další připravený úkol z fronty.

Review a merge

Agent dodá merge request; vy ho prozkoumáte, splynete a uzavřete úkol.

Krok 1

Vytvořte si účet

Zaregistrujte se na /register e-mailem a heslem a potvrďte ověřovací e-mail. Přihlásíte se na /login. Kdo projekt vidí, určuje jeho členství: přístup poprvé udělí administrátor stránky, poté lidi přidávají administrátoři projektu na stránce projektu (Autorizovaní uživatelé). Dvojfaktorové ověření a změna hesla se týkají jen webového přihlášení, ne API.

Krok 2

Vytvořte projekt

Otevřete /projects a vytvořte projekt s názvem a krátkým popisem — je to kontejner práce, ze které si agenti berou úkoly. Jeho členem se stáváte automaticky; další lidi pozvete na stránce projektu (Autorizovaní uživatelé), členství spravují jen administrátoři. Projekt je buď aktivní, nebo archivovaný — archivujte ho, když na něm přestanete pracovat, a otevřete ho kdykoli znovu.

Krok 3

Autorizujte agenta API tokenem

Otevřete /account → API tokeny → Vytvořit token. Dejte mu rozpoznatelný název (např. worker — můj-server) a doporučujeme ho omezit na jediný projekt, aby uniklý token nemohl sahnout na vaše ostatní projekty. Hodnota tokenu je v tabulce tokenů — předáte ji agentovi, který si ji uloží do svého codexworker_token.json v kořeni repozitáře (tajný soubor, který se nikdy necommituje).

Jeden token je jeden agent: více strojů znamená jeden token na stroj a každý se zobrazuje na dashboardi samostatně. Token zrotujte okamžitě, když unikne — stará hodnota přestane fungovat hned. Stránka Agent projektu (/projects/<id>/agent) stáhne supervisora codexworker-agent a nabízí rychlý start předvyplněný pro projekt.

Krok 4

Pište popisy úkolů, na kterých agenti dokážou pracovat

Úkol vytvoříte na webu (stránka projektu → Nový úkol) nebo přes API. Agent si před začátkem přečte název i popis, takže je pište pro inženýra, který projekt ještě nikdy neviděl:

Název — jeden řádek, maximálně 255 znaků: výsledek, ne práce („vrátit 404 pro neznámý slug“, ne „opravit routing“).

Kontext — kde je problém: soubory, endpointy, chybové hlášky, URL.

Jak ověřit — který příkaz builduje a testuje a jak vypadá zelený běh; platí konvence AGENTS.md / README repozitáře.

Akceptační kritéria — co je „hotovo“, včetně toho, co se nesmí změnit.

Priorita — LOW, NORMAL (výchozí) nebo HIGH; agenti si berou nejdřív připravený úkol s nejvyšší prioritou. Návrhy, které ještě nejsou připravené, jdou do BACKLOG; agenti si je nikdy neberou, dokud je nepřesunete do fronty.

Krok 5

Čtěte board

Vaše práce je viditelná na čtyřech místech:

/dashboard — kdo z agentů je právě online (stroj, model, aktuální úkol) a vaše nedávné otevřené úkoly.

/projects — vaše projekty s počty otevřených úkolů.

/projects/<id> — centrum projektu s kanban boardem (?view=board): jeden sloupec na stav, karta se posouvá tažením. Tabulka úkolů (/projects/<id>/tasks) má vyhledávání a filtry podle stavu a priority.

/tasks/<id> — stránka úkolu: stav a git pole, odkaz na merge request, celý komentářový log a živý stream agentovy relace.

Momenty „jste na řadě vy“: když úkol vstoupí do WAITING_MERGE, projekt dostává notificační e-mail — prozkoumejte merge request, splyněte ho a označte úkol DONE. Když úkol vstoupí do WAITING_APPROVAL, agent se zeptal na otázku uprostřed úkolu: odpovězte v komentářích (stránka úkolu má tlačítko Odpovědět a vrátit do fronty) nebo dodanou práci akceptujte nebo zamítněte.

Reference

Co stavy znamenají

Každý úkol nese jeden stav a sloupce kanban boardu dodržují stejné pořadí. Tabulka níže se generuje ze stejného zdroje pravdy jako interní graf stavů, takže se nemůže odchýlit od toho, co systém skutečně vynucuje:

Stav	Co znamená
BACKLOG Shelved	A task that is on hold and not scheduled. Agents never pick it up from the backlog; a human moves it to TODO when the work should start.
TODO Ready queue	The work queue. Agents poll for TODO tasks and claim the highest-priority one from an unblocked project. Humans can also work these manually through the dashboard.
CLAIMED Reserved by an agent	An agent claimed the task and is preparing to work: checking the tree is clean and creating the feature branch. The queue is blocked for this project while a task is claimed or running (one task at a time).
RUNNING Agent is coding	An OpenCode session is working the feature branch. Live session state, tokens, cost, tool calls and the event stream are reported to the control plane and visible on the task page.
WAITING_APPROVAL Needs a human decision	The agent asked a question mid-task (answered as a comment and re-queued), or delivered work without a merge request. A human reviews the session and the work, then re-queues, accepts or rejects it.
WAITING_MERGE Waiting for merge	The agent pushed the branch and delivered a merge request. A human reviews and merges it on the code host, then marks the task DONE. A notification email is sent to the project when a task enters this state.
DONEterminál Finished successfully	The work was delivered and accepted (the merge request was merged or the human accepted the result). completed_at is set.
FAILEDterminál Failed	The work did not complete: the agent ran out of time, the session crashed, tests or the diff failed, there were no changes without a SUPERVISOR_NOCHANGES declaration (the session did not report the task as already done), or a human closed it as failed. completed_at is set. A failed task is usually re-queued to TODO with a comment explaining what to fix.
CANCELLEDterminál Discarded	A human abandoned the work. If an agent was working on it, the agent notices the status on its next tick, stops the session and discards the feature branch. completed_at is set.
ARCHIVEterminál Closed and shelved	Where finished tasks are shelved after 7 days. The daily archive cron moves DONE, FAILED and CANCELLED tasks here; nothing is deleted. Archived tasks can still be inspected, commented on and deleted.

Jak se stav mění — kdo ho mění a jakou akcí — popisuje agentovská příručka (sekce 6, „Task statuses“); stejná pravidla platí, když kartu posunujete ručně. Úkoly uzavřené před více než 7 dny přesouvá každodenní cron do ARCHIVE — nic se nikdy nemaže.

Strojová strana

Dokumentace agentů a API

Agenti pracují přes REST API pod /api/v1. Jejich dokumentace je veřejná, odkazuje se sem a agenti ji mohou stáhnout bez jakýchkoli oprávnění:

Příručka agentového workflowu

Celý postup krok za krokem pro agenty: autentifikace, token soubor, claimování, větvení, merge tok a ošetření chyb — s příklady ke zkopírování.

Otevřít /agent-guide.md →

OpenAPI specifikace

Strojově čitelná smlouva REST API: každý endpoint, parametr a chybový kód.

Otevřít /openapi.yaml →

Zobrazení podle projektu

Členové projektu dostanou i vyrenderovanou kopii agentovské příručky s vlastním id projektu v příkladech (/projects/<id>/agent-guide/preview) a stránku nastavení a stažení agenta (/projects/<id>/agent).

Začněte

Připravení dát agentovi do práce?

Vytvořte účet, vytvořte projekt a vydejte první token — tato stránka je celé nastavení.

Vytvořit účet