Werk met codeeragenten vanaf de terminal
Een terminalcodeeragent zoals Claude Code of Codex kan een Kanera-kaart van ophalen naar klaar brengen: lees de kaart, kondig aan dat deze werkt, rapporteer de voortgang, markeer wanneer er iemand nodig is en markeer de kaart als voltooid. Deze gids stelt die lus in met de Kanera CLI, wat werkt voor elke agent die shell-opdrachten kan uitvoeren.
Installeren en inloggen
Installeer de CLI één keer op de machine waarop de agent draait. Het heeft knooppunt 22 of nieuwer nodig.
npm install --global @kanera/cli
kanera auth login --agent "Claude Code" # use your agent's own product name
kanera auth login drukt een link en een code af en opent de link in uw browser. Keur het verzoek daar goed nadat u hebt gecontroleerd of de code overeenkomt, en de CLI slaat een aanmelding op die zichzelf vernieuwt. Gebruik voor een agent die onbeheerd wordt uitgevoerd, zoals in CI kanera auth login --with-api-key met een sleutel van Profielinstellingen -> API-sleutels in plaats daarvan, en kies Alleen-lezen als er niets aan verandert. Bevestig vervolgens wat de agent kan doen:
kanera whoami # the user and the credential's scope
kanera doctor # credentials, connectivity, and the API address in use
Voor een sandbox- of CI-taak slaat u het opgeslagen profiel over en stelt u dit in KANERA_API_KEY in plaats daarvan. Zie Kanera CLI voor benoemde profielen en zelf-gehoste adressen.
Alleen-lezen of schrijven
Kies de reikwijdte van de sleutel voor de taak, niet voor het gemak.
- Alleen-lezen past bij een agent die alleen maar werk hoeft te vinden en lezen: triageren, een kaart samenvatten voordat je begint, of antwoorden "wat ligt er op mijn bord?". Kanera weigert elke wijziging bij de API, wat de agent ook probeert.
- Schrijf is nodig voor al het andere op deze pagina: een run openen, commentaar geven en kaarten voltooien. Kanera controleert nog steeds uw rol op elk bord, zodat de agent een bord waarop u waarnemer bent, niet kan wijzigen.
Een geweigerd schrijven wordt afgesloten met code 4, anders dan bij een gewone storing, zodat de agent kan stoppen en het u kan vertellen in plaats van het opnieuw te proberen. Beveiliging van agenten behandelt hoe u de toegang van een agent kunt beperken.
Installeer de agentinstructies
kanera setup schrijft instructies die de agent leren hoe hij de CLI veilig kan gebruiken: controleer eerst de reikwijdte van de sleutel, ontdek opdrachten met kanera commands --json in plaats van te raden, gebruik --quiet of --json bij het parseren van de uitvoer, en behandel destructieve tools alsof ze een expliciet verzoek nodig hebben.
kanera setup claude # writes .claude/skills/kanera/SKILL.md in the current directory
kanera setup claude --global # writes ~/.claude/skills/kanera/SKILL.md for every project
kanera setup codex # adds a Kanera section to AGENTS.md in the current directory
kanera skill # prints the skill document, for any other agent
setup claudeinstalleert de Agent Skill van Kanera, die Claude Code laadt wanneer Kanera verschijnt. Het zal een bestaand bestand niet overschrijvenSKILL.md; opnieuw mee rennen--forceom deze te vervangen na het upgraden van de CLI.setup codexcreëertAGENTS.mdals deze niet bestaat, of voegt een korte Kanera-sectie toe. Het is veilig om opnieuw uit te voeren: als het bestand al Kanera documenteert, verandert er niets.kanera setup agentsdoet hetzelfde, voor elke agent die leestAGENTS.md.
Beide opzetdoelen omvatten de werklus: wanneer hem wordt gevraagd een kaart uit te voeren, start de agent een run, houdt de voortgang zichtbaar, geeft commentaar op de uitkomst en verplaatst de kaart naar de juiste lijst voordat hij definitief antwoordt. Alleen-lezen vragen, verkenningsplannen, concept-aanvragen en expliciete limieten geven geen toestemming voor deze schrijfbewerkingen. Bestaande installaties behouden hun oude instructies: vernieuw na het upgraden de Claude-vaardigheid met --force, of update de bestaande Kanera-sectie in AGENTS.md gebruik makend van de stroom kanera skill uitgang. Pas de aan projectinstructies hieronder voor uw werkstroom.
De werklus
Elke stap hieronder is een opdracht die de agent uitvoert. Kaartargumenten accepteren een sleutel zoals MKT-42, een kaart-ID of een kaart-URL.
1. Werk oppakken
kanera work --json # your assigned work across every board
kanera work --filters.q "checkout" --json # narrowed by card text
kanera priorities --json # your ranked Up next queue
kanera card MKT-42 --json # the card itself: description, checklists, fields
kanera card history MKT-42 --json # its activity and comments
kanera priorities is handig als u een Hierna wachtrij: de agent kan de bovenste kaart pakken in plaats van voor zichzelf te kiezen.
2. Open een run
Lees vóór het inhoudelijke werk de relevante opmerkingen en bordconfiguratie, controleer of er niemand anders op de kaart staat en open vervolgens een run. Hervat uw eigen liverun voor dezelfde taak; rapporteer de live run van een andere agent voordat hij overlappend werk doet:
kanera comments MKT-42 --json
kanera board <boardId> --json # lists and their actual IDs
kanera runs MKT-42 --json
RUN_ID=$(kanera run start MKT-42 "Fixing the checkout rounding bug" \
--externalUrl "https://github.com/acme/shop/pull/318" \
--quiet | jq -r .id)
De kaarttegel toont nu een live-chip die aangeeft dat de agent aan het werk is, en de kaartdetails tonen de run met de titel en voortgangsnotitie. --externalUrl is optioneel; geef het het pull-verzoek, vertakking of sessielogboek dat een persoon kan openen. Zie Agentruns en attributie voor wat iedereen ziet.
Noteer de oorspronkelijke lijst-ID, naam en workflow-betekenis van de kaart voordat u deze verplaatst. Gebruik kanera card move om het in de beschikbare lijst te plaatsen die actief werk in de workflow van dit bord vertegenwoordigt. Met runs worden de kaarten niet verplaatst. Los de lijst op vanuit de configuratie van het bord en sla de zet over als deze al aanwezig is; kanera help cards.move beschrijft de vereiste ankerargumenten. Ga er niet van uit dat elk bord de Agent Workflow-sjabloon gebruikt.
3. Rapporteer voortgang
Werk de run bij terwijl het werk beweegt. Elke update is ook een hartslag, en een run van een kwartier zonder één wordt gemarkeerd vastgelopen, dus bij lange taken moet de agent minstens elke tien minuten een update uitvoeren.
kanera run update "$RUN_ID" --summary "Reproduced; fix drafted, running the test suite"
Het runoverzicht is een statusregel die door elke update wordt vervangen. Voor alles wat het team moet behouden, kunt u op de kaart commentaar geven:
kanera comment MKT-42 "Root cause: totals were rounded per line, not per order. Fix in PR 318."
Geef elke bedoelde opmerking of voer een nieuwe creatie uit --idempotencyKey UUID en gebruik deze alleen wanneer u opnieuw probeert te schrijven na een dubbelzinnige fout. Als een antwoord zonder sleutel verloren is gegaan, controleer dan de kaart voordat u het opnieuw probeert om duplicaten te voorkomen.
4. Markeer een blokkering
Wanneer de agent een beslissing, goedkeuring of toegang nodig heeft, markeert u de run blocked en zeg wat het nodig heeft:
kanera run update "$RUN_ID" --status blocked \
--summary "Need a decision: round half up or half even?"
kanera comment MKT-42 "Blocked: should order totals round half up or half even? Both are drafted in PR 318."
De chip wordt oranje en het kaartdetail is zichtbaar Ik wacht op jou. Als u een run als geblokkeerd markeert, wordt op zichzelf niemand hiervan op de hoogte gesteld. Daarom is de opmerking belangrijk: deze bereikt de toeschouwers en rechthebbenden van de kaart. Kies een lijst die de blokkering in de workflow van dit bord weerspiegelt. Wanneer de agent verdergaat, wordt de run teruggezet op --status running en verplaatst de kaart terug naar de actieve lijst.
Als een andere kaart vereist is, maak dan ook een kaartafhankelijkheid: kanera card block API-42 WEB-18 betekent API-42 blokkeert WEB-18. Een geblokkeerde run beschrijft de status van de agent; het creëert deze relatie niet. Gebruik kanera work --filters.blockedOnly true om wachtkaarten te vinden, en kanera deps WEB-18 om de directe vereisten en transitieve stroomopwaartse/stroomafwaartse keten ervan te lezen.
5. Voltooi
Plaats vóór het definitieve antwoord een duurzaam resultaatcommentaar met wat er is veranderd of gevonden, de verificatie en de resultaten ervan (inclusief mislukkingen of overgeslagen controles), relevante PR/commit/artefact-koppelingen en het resterende werk of de resterende beslissingen. Markeer alleen checklistitems die daadwerkelijk zijn voltooid. Beëindig vervolgens de run en routeer de kaart:
kanera comment MKT-42 "Rounding is now per order. Focused regression checks pass; full suite not run. PR 318 is ready for review; merge and deployment remain."
kanera run done "$RUN_ID" "Implementation ready for review in PR 318"
kanera card move MKT-42 <destinationListId> --anchor '{"side":"after","id":null}'
kanera card MKT-42 --json
De slotsamenvatting van de run wordt een klaar rij in activiteit; het vervangt niet het resultaatcommentaar, verplaatst de kaart niet en maakt deze niet compleet. Een succesvolle run kan slechts een deel van een kaart beslaan. Vul de kaart alleen in als de overeengekomen workflow dit toelaat en aan de criteria is voldaan.
Voordat u de kaart verplaatst, moet u deze en het bord opnieuw lezen. Denk eens aan de oorspronkelijke lijst, de momenteel beschikbare lijsten en hun betekenis, wat er is voltooid en wat er nog over is. Kies de lijst die het beste de werkelijke status van de kaart weergeeft in de workflow van dit bord. Terugkeren naar de oorspronkelijke lijst kan passend zijn, maar gebeurt niet automatisch. Ga niet uit van lijstnamen en kies niet alleen uit de lijstvolgorde of de actieve instelling. Leg de keuze uit in het uitkomstcommentaar.
Als het opgedragen werk niet kon worden voltooid, leg dan uit wat er nog overblijft en beëindig de run met --status failed of --status cancelled. Houd blocked alleen als je echt wacht om te hervatten; laat het gestopte werk niet doorlopen. Een beëindigde run kan niet worden gewijzigd; als het werk later wordt hervat, start dan een nieuwe run.
Controleer de resulterende kaartlijst, het resultaatcommentaar en de runstatus op basis van de schrijfresultaten en een nieuwe lezing. Houd rekening met automatiseringen en de tussenliggende actie van een teamgenoot. Als er geen bestemming duidelijk is, laat dan de huidige lijst ongewijzigd, sla de eventuele run/commentaar-updates op en vraag alleen naar de ontbrekende routekeuze. Als een schrijfbewerking wordt geweigerd, rapporteer dan de beperking en welke trackingstappen nog niet zijn opgeslagen; impliceert geen succes. Het uiteindelijke antwoord moet de kaart koppelen en de resulterende lijst en uitvoeringsstatus vermelden.
Aan wie het werk wordt toegeschreven
Hoe de ingelogde CLI bepaalt hoe het werk van de agent wordt gelabeld:
| Referentie | Opmerkingen en kaartwijzigingen | Voer het chiplabel uit |
|---|---|---|
Browseraanmelding met --agent (kanera auth login --agent "Claude Code") | Zoals jij, via Claude-code (Kanera CLI op computernaam) | Claude Code (Kanera CLI op computernaam) |
Browseraanmelding zonder --agent | Zoals jij, via Kanera CLI (computernaam) | Kanera CLI (computernaam) |
| Persoonlijke API-sleutel | Zoals jij, met nr via kenteken | API-client |
| Werkruimte of bord API-sleutel | Zoals de naam van de sleutel | De naam van de sleutel |
Een browseraanmelding is een OAuth-apparaatverbinding, dus het werk van de agent draagt een via badge, afzonderlijk gegroepeerd in uw meldingen en gescheiden gehouden van uw eigen werk in Work Done, net als bij MCP. Kanera ziet alleen de CLI, dus geef de agent een naam wanneer u zich aanmeldt --agent (of KANERA_AGENT_NAME). De naam voor die aanmelding staat vast; geef elke agent zijn eigen profiel als meerdere een machine delen. Via MCP geeft de agent zichzelf een naam; zie Zet Claude op of Codex instellen. kanera mcp, de lokale MCP-server van de CLI, gebruikt dezelfde opgeslagen referentie en dus dezelfde attributie als de CLI.
Voeg het toe aan uw projectinstructies
De huidige kanera setup claude en kanera setup codex instructies omvatten deze lus. Om het acceptatiebeleid van uw project expliciet te maken, past u dit onderdeel aan CLAUDE.md of AGENTS.md:
## Kanera card work
Use connected Kanera MCP tools when available, otherwise the Kanera CLI.
When asked to carry out a card, keep it updated as part of the assignment:
- Read the card, relevant comments and board lists; record the original list ID/name/meaning and check for another live agent run.
- Start a run before substantive work and move to the board's active list.
- Keep progress current at milestones and at least every ten minutes.
- When blocked, update the run, comment what you need and move to the waiting list.
- Before the final reply, comment changes, checks/results, relevant links and remaining work.
- End the run appropriately. Re-read the card and board; consider the original list, available lists
and their meanings, completed work and remaining work. Choose the list that reflects the card's
actual state in this board's workflow, without assuming names or automatically restoring its
original list. Explain the choice in the comment. If unclear, leave the list unchanged and ask.
Complete the card only when the agreed workflow permits it and its criteria are met.
- Verify the saved comment, run status and card list; report any tracking writes that failed.
- Read-only or exploratory requests cause no tracking writes; explicit user limits win.
Koppel het met een schrijfsleutel. Met een alleen-lezen-sleutel behoudt u alleen de leesstappen.