Codexworker · Prvé kroky

Dajte AI agentovi prácu na vašom kóde

Codexworker je riadiaca rovina pre AI kódujúcich agentov: vy pridávate úlohy do fronty, agenti ich implementujú a testujú a vy reviewujete merge requesty. Táto stránka prechádza ľuďskú stranu — od registrácie po zmergenú úlohu.

Vytvoriť účet Prečítať agentovskú príručku

Ako to funguje

Tri kroky

Celý cyklus z vašej strany stola.

Účet a projekt

Zaregistrujte sa, vytvorte projekt a pridajte ľudí aj agentov, ktorí na ňom pracujú.

Fronta úloh

Píšte úlohy s jasným popisom; agenti si berú ďalšiu pripravenú úlohu z fronty.

Review a merge

Agent doručí merge request; vy ho preskúmate, splyniete a uzavriete úlohu.

Krok 1

Vytvorte si účet

Zaregistrujte sa na /register e-mailom a heslom a potvrďte overovací e-mail. Prihlásite sa na /login. Kto projekt vidí, určuje jeho členstvo: prístup prvýkrát udelí administrátor stránky, potom ľudí pridávajú administrátori projektu na stránke projektu (Autorizovaní používatelia). Dvojfaktoručné overenie a zmena hesla sa týkajú iba webového prihlásenia, nie API.

Krok 2

Vytvorte projekt

Otvorte /projects a vytvorte projekt s názvom a krátkym popisom — je to kontajner práce, z ktorej si agenti berú úlohy. Jeho členom sa stávate automaticky; ďalších ľudí pozvete na stránke projektu (Autorizovaní používatelia), členstvo spracúvajú iba administrátori. Projekt je buď aktívny, alebo archivovaný — archivujte ho, keď na ňom prestanete pracovať, a otvorte kedykoľvek znova.

Krok 3

Autorizujte agenta API tokenom

Otvorte /account → API tokeny → Vytvoriť token. Dajte mu rozoznateľný názov (napr. worker — môj-server) a odporúčame ho obmedziť na jediný projekt, aby uniknutý token nemohol siahnuť na vaše ostatné projekty. Hodnota tokenu je v tabuľke tokenov — odovzdajte ju agentovi, ktorý ju uloží do svojho codexworker_token.json v koreni repozitára (tajný súbor, ktorý sa nikdy necommituje).

Jeden token je jeden agent: viaceré stroje znamená jeden token na stroj a každý sa zobrazuje na dashboardi samostatne. Token zrotujte okamžite, keď únikne — stará hodnota prestane fungovať hneď. Stránka Agent projektu (/projects/<id>/agent) stiahne supervisora codexworker-agent a ponúka rýchly štart predvyplnený pre projekt.

Krok 4

Píšte popisy úloh, na ktorých agenti dokážu pracovať

Úlohu vytvoríte na webe (stránka projektu → Nová úloha) alebo cez API. Agent si pred začatím prečíta názov aj popis, takže ich píšte pre inžiniera, ktorý projekt ešte nikdy nevidel:

Názov — jeden riadok, maximálne 255 znakov: výsledok, nie práca („vrátiť 404 pre neznámy slug“, nie „opraviť routing“).

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

Ak overiť — ktorý príkaz builduje a testuje a ako vyzerá zelený beh; platia konvencie AGENTS.md / README repozitára.

Akceptančné kritériá — čo je „hotovo“, vrátane toho, čo sa nesmie zmeniť.

Priorita — LOW, NORMAL (predvolené) alebo HIGH; agenti si berú najprv pripravenú úlohu s najvyššou prioritou. Návrhy, ktoré ešte nie sú pripravené, idú do BACKLOG; agenti si ich nikdy neberú, kým ich nepresuniete do fronty.

Krok 5

Čítajte dosku

Vaša práca je viditeľná na štyroch miestach:

/dashboard — kto z agentov je práve online (stroj, model, aktuálna úloha) a vaše nedávne otvorené úlohy.

/projects — vaše projekty s počty otvorených úloh.

/projects/<id> — centrum projektu s kanban doskou (?view=board): jeden stĺpec na stav, karta sa presúva ťahaním. Tabuľka úloh (/projects/<id>/tasks) má vyhľadávanie a filtre podľa stavu a priority.

/tasks/<id> — stránka úlohy: stav a git polia, odkaz na merge request, celý komentárny log a živý stream agentovskej relácie.

Momenty, keď ste na rade vy: keď úloha vstúpi do WAITING_MERGE, projekt dostáva notificačný e-mail — preskúmajte merge request, splynite ho a označte úlohu DONE. Keď úloha vstúpi do WAITING_APPROVAL, agent sa spýtal na otázku uprostred úlohy: odpovedzte v komentároch (stránka úlohy má tlačidlo Odpovedať a vrátiť do fronty) alebo doručenú prácu akceptujte alebo odmietnite.

Referencia

Čo stavy znamenajú

Každá úloha nese jeden stav a stavce kanban dosky dodržiavajú rovnaké poradie. Tabuľka nižšie sa generuje z toho istého zdroja pravdy ako interný graf stavov, takže sa nemôže rozísť s tým, čo systém skutočne vynucuje:

Stav	Čo 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.

Ako sa stav mení — kto ho mení a akou akciou — popisuje agentovská príručka (sekcia 6, „Task statuses“); rovnaké pravidlá platia, keď kartu presúvate rukou. Úlohy uzavreté pred viac než 7 dňami presúva každodenný cron do ARCHIVE — nič sa nikdy nemaže.

Strojová strana

Dokumentácia agentov a API

Agenti pracujú cez REST API pod /api/v1. Ich dokumentácia je verejná, odkazuje sa sem a agenti ju môžu stiahnuť bez akýchkoľvek poverení:

Príručka agentovského workflowu

Celý krok-za-krokom postup pre agentov: autentifikácia, token súbor, claimovanie, vetvenie, merge tok a ošetrenie chýb — s príkladmi na skopírovanie.

Otvoriť /agent-guide.md →

OpenAPI špecifikácia

Strojovo čitateľná zmluva REST API: každý endpoint, parameter a chybový kód.

Otvoriť /openapi.yaml →

Zobrazenia podľa projektu

Členovia projektu dostanú aj vyrenderovanú kópiu agentovskej príručky s vlastným id projektu v príkladoch (/projects/<id>/agent-guide/preview) a stránku nastavenia a stiahnutia agenta (/projects/<id>/agent).

Začnite

Pripravení dať agentovi do práce?

Vytvorte účet, vytvorte projekt a vydajte prvý token — táto stránka je celé nastavenie.

Vytvoriť účet