Arbeid med kodingsagenter fra terminalen
En terminal kodeagent som Claude Code eller Codex kan ta et Kanera-kort fra pick-up til ferdig: lese kortet, kunngjøre at det fungerer, rapportere fremgang, flagg når det trenger en person, og merke kortet komplett. Denne guiden setter som loop opp med Kanera CLI, som fungerer for alle agenter som kan kjøre shell-kommandoer.
::::tips Tilkoblet MCP verktøy kommer først Hvis agenten din kan koble til Kanera's vert MCP server, bruk den i stedet. Lim inn installasjonsprompten fra Koble Kanera til din AI-agent og agenten får de samme verktøyene over OAuth, med sitt arbeid merket cialis <sekretær>. CLI er ruten for en agent som har et skall, men ingen MCP-tilkobling. Løkken nedenfor er den samme uansett; bare transporten endres. :::
Installer og logg inn
Installer CLI en gang på maskinen agenten kjører på. Den trenger Node 22 eller nyere.
npm install --global @kanera/cli
kanera auth login --agent "Claude Code" # use your agent's own product name
kanera auth login skriver ut en lenke og en kode og åpner lenken i nettleseren din. Godkjenn forespørselen der etter å ha sjekket koden samsvarer, og CLI lagrer en pålogging som fornyer seg selv. For en agent som kjører uten tilsyn, for eksempel i CI, bruk kanera auth login --with-api-key Med nøkkel fra Profilinnstillinger -> API-nøkler I stedet, og velg Skrivebeskyttet hvis det ikke skulle endre noe. Deretter bekrefte hva agenten vil være i stand til å gjøre:
kanera whoami # the user and the credential's scope
kanera doctor # credentials, connectivity, and the API address in use
For en sandkasse eller CI-jobb, hopp over den lagrede profilen og sett KANERA_API_KEY i stedet. Se Kanera CLI for navngitte profiler og selvbetjente adresser.
Skrivebeskyttet eller skrive
Velg nøkkelens omfang for jobben, ikke for bekvemmelighet.
- Skrivebeskyttet passer en agent som bare trenger å finne og lese arbeid: triaging, oppsummere et kort før du starter, eller svare "hva er på tallerkenen min?". Kanera nekter hver endring på API, uansett hva agenten prøver.
- Skriv er nødvendig for alt annet på denne siden: åpne en kjøre, kommentere, og fullføre kort. Kanera fortsatt sjekker din rolle på hver tavle, slik at agenten ikke kan endre en tavle der du er en observatør.
En nektet skriveutgang med kode 4Dette er forskjellig fra en vanlig feil, slik at agenten kan stoppe og fortelle deg i stedet for å prøve igjen. Agent sikkerhet Dekker hvordan å dekke en agents tilgang.
Installer agentinstruksjonene
kanera setup skriver instruksjoner som lærer agenten hvordan du bruker CLI trygt: sjekk nøkkelens omfang først, oppdag kommandoer med kanera commands --json I stedet for å bruke --quiet eller --json når du analyserer utdata, og behandler destruktive verktøy som trenger en eksplisitt forespørsel.
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 claudeinstallerer Kanera's Agent Skill, som Claude Code laster inn når Kanera kommer opp. Det vil ikke overskrive en eksisterendeSKILL.md; re-run med--forceDette må erstattes etter oppgradering av CLI.setup codexskaperAGENTS.mdhvis den ikke eksisterer, eller legger til en kort Kanera-seksjon. Det er trygt å kjøre på nytt: når filen allerede dokumenterer Kanera, endres ingenting.kanera setup agentsDet samme gjelder for alle som leserAGENTS.md.
Begge oppsettmålene inkluderer arbeidssløyfen: Når agenten blir bedt om å utføre et kort, starter han et løp, holder fremgangen synlig, kommenterer resultatet og flytter kortet til riktig liste før det endelige svaret. Skrivebeskyttede spørsmål, utforskende planer, kun utkastforespørsler og eksplisitte grenser tillater ikke disse skrivingene. Eksisterende installasjoner beholder sine gamle instruksjoner: Etter oppgradering, oppdater Claude-ferdighetene med --forceeller oppdatere den eksisterende Kanera-delen i AGENTS.md Ved å bruke den nåværende kanera skill utdata. Tilpass prosjektinstruksjoner nedenfor for arbeidsflyten din.
Arbeidsløkken
Hvert trinn nedenfor er en kommando som agenten kjører. Kortargumenter godtar en nøkkel som MKT-42, et kort-ID eller en kort-URL.
1. Plukk opp arbeid
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 Det er nyttig når du holder en Neste Kø: Agenten kan ta det øverste kortet i stedet for å velge selv.
2. Åpne en løp
Før du utfører et omfattende arbeid, les de relevante kommentarene og oppsettet av tavlen, kontroller at ingen andre er på kortet, og åpne deretter en runde. Fortsett din egen live-runde for den samme oppgaven; rapporter en annen agents live-runde før du gjør overlappende arbeid:
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)
Kortet flisen viser nå en live chip sier agenten jobber, og kort detalj viser løpet med sin tittel og fremgang notat. --externalUrl er valgfritt; gi den en pull-forespørsel, gren eller øktlogg som en person kan åpne. Se Agent kjører og tilskriving For det alle andre ser.
Ta opp kortets opprinnelige liste-ID, navn og arbeidsflyt-betydning før du flytter det. Bruk kanera card move for å plassere den i den tilgjengelige listen som representerer aktivt arbeid i dette forumets arbeidsflyt. Kjører flytter ikke kort. Løs listen fra forumets konfigurasjon og hopp over flyttingen hvis den allerede er der; kanera help cards.move beskriver de nødvendige ankerargumentene. Ikke anta at alle tavle bruker malen for agentarbeidsflyt.
3. Rapporter fremgang
Oppdater kjøringen etter hvert som arbeidet går. Hver oppdatering er også et hjerteslag, og et løp som går femten minutter uten en er merket støpingPå lange oppgaver bør agenten oppdatere minst hvert tiende minutt.
kanera run update "$RUN_ID" --summary "Reproduced; fix drafted, running the test suite"
Kjøresammendraget er en statuslinje som hver oppdatering erstatter. For alt teamet skal beholde, kommenter kortet:
kanera comment MKT-42 "Root cause: totals were rounded per line, not per order. Fix in PR 318."
Gi hver tiltenkt kommentar eller kjøre opprettelsen en frisk --idempotencyKey UUID og gjenbruk det bare når du prøver å skrive etter en tvetydig feil. Hvis et svar gikk tapt uten en nøkkel, sjekk kortet før du prøver å unngå duplikater.
4. Flagg en blokkering
Når agenten trenger en avgjørelse, en godkjenning eller tilgang den ikke har, merker du løpet blocked Og si hva den trenger:
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."
Chippen blir gul og kortdetaljer viser Venter på deg. Merking av en løp blokkert varsler ikke noen av seg selv, og derfor er kommentaren viktig: den når kortets overvåkere og oppdragsgivere. Velg en liste som gjenspeiler blokkeringen i dette forumets arbeidsflyt. Når agenten fortsetter, setter den kjøringen tilbake til --status running og flytter kortet tilbake til den aktive listen.
Hvis et annet kort er forutsetningen, også opprette en kortavhengighet: kanera card block API-42 WEB-18 betyr API-42 blokker WEB-18. En blokkert kjøring beskriver agentens status; det oppretter ikke dette forholdet. Bruk kanera work --filters.blockedOnly true for å finne ventekort, og kanera deps WEB-18 å lese dens direkte forutsetninger og transitive oppstrøms/nedstrøms kjede.
5. Fullfør
Før det endelige svaret, legg inn en varig utfallskommentar med hva som er endret eller funnet, verifisering og resultatene (inkludert feil eller hoppet over sjekker), relevante PR / forpliktelse / artefaktkoblinger og gjenværende arbeid eller beslutninger. Merk bare sjekklisteelementer som faktisk er fullført. Avslutt deretter løpet og rute kortet:
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
Den avsluttende oppsummeringen blir en ferdig rad i aktivitet; det erstatter ikke resultatet kommentar, flytte kortet, eller fullføre den. En vellykket kjøring kan dekke bare en del av et kort. Fullfør kortet bare når avtalt arbeidsflyten tillater det og dens kriterier er oppfylt.
Før du flytter kortet, les det og tavlen på nytt. Vurder den opprinnelige listen, de tilgjengelige listene og deres betydninger, hva som ble fullført, og hva som gjenstår. Velg listen som best representerer kortets faktiske tilstand i dette brettets arbeidsflyt. Å gå tilbake til den opprinnelige listen kan være hensiktsmessig, men er ikke automatisk. Ikke anta listenavn eller velg fra listerekkefølge eller innstillingen for pågående arbeid alene. Forklar valget i utfallet kommentar.
Hvis det tildelte arbeidet ikke kunne fullføres, forklar hva som gjenstår og avslutt kjøringen med --status failed eller --status cancelled. Behold blocked bare når du virkelig venter på å fortsette; ikke la stoppet arbeid kjøre. En avsluttet kjøring kan ikke endres; Hvis arbeidet gjenopptas senere, start en ny kjøring.
Kontroller den resulterende kortlisten, resultatkommentaren og kjørestatusen fra skriveresultatene og en ny lesing. Regnskap for automatiseringer og en lagkamerats mellomliggende trekk. Hvis ingen destinasjon er klar, la gjeldende liste være uendret, lagre kjøre / kommentaroppdateringene du kan og be bare om det manglende rutingsvalget. Hvis en skrive blir nektet, rapporter begrensningen og hvilke sporingstrinn forblir ulagret; ikke impliker suksess. Det endelige svaret skal koble kortet og oppgi den resulterende statusen.
Hvem arbeidet er tilskrevet
Hvordan CLI-en som er logget inn, bestemmer hvordan agentens arbeid er merket:
| Kjente personer | Kommentarer og kortendringer | Kjør chip etikett |
|---|---|---|
Logg på med nettleseren --agent (kanera auth login --agent "Claude Code") | Som deg, via Claude Code (Kanera CLI på datamaskinnavn) | Claude Code (Kanera CLI på datamaskinens navn) |
Nettleserinnlogging uten --agent | Som deg, via Kanera CLI (datamaskinnavn) | Kanera CLI (datamaskinnavn) |
| Personlig API-nøkkel | Som deg, uten cialis cialis | API-klient |
| Arbeidsområde eller API-nøkkel for tavle | Som navnet på nøkkelen | Nøkkelens navn |
En nettleserinnlogging er en OAuth-enhetstilkobling, slik at agentens arbeid bærer en cialis skilt, grupper separat i varslinger, og holdes adskilt fra ditt eget arbeid i arbeid gjort, det samme som over MCP. Kanera ser bare CLI, så navngi agenten når du logger på med --agent (eller KANERA_AGENT_NAME). Navnet er fastsatt for den påloggingen; gi hver agent sin egen profil hvis flere deler en maskin. Over MCP navn agenten selv; se Sett opp Claude eller Sett opp Codex. kanera mcp, den CLI's lokale MCP bruker samme lagrede legitimasjon og dermed samme attributt som CLI.
Legg den til i prosjektinstruksjonene dine
Den nåværende kanera setup claude og kanera setup codex Hvis du vil gjøre prosjektets akseptpolitikk eksplisitt, kan du tilpasse denne delen i CLAUDE.md eller 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.
Par den med en skrivetast. Med en skrivebeskyttet nøkkel, behold bare lesetrinnene.