← Arkiv
Projekt5 min läsningWebb / MCP / Claude

Relay: ett eget ärendeverktyg för mig och Claude

Jag ville ha ärendena på egen server och kontroll över verktyget, så jag ersatte Linear med ett eget ärendeverktyg. Relay har en bräda för mig och en MCP-server för Claude, med samma verktygsnamn som Linear. Det håller reda på vems tur det är, och en webhook kan väcka en Claude-session. Byggt med Claude Code.

Brädan i Relay för projektet Garden Planner: kolumnerna Backlog, Todo, In Progress och Done, med kort märkta Claude eller Your turn.

Brädan i Relay för projektet Garden Planner: kolumnerna Backlog, Todo, In Progress och Done, med kort märkta Claude eller Your turn.

RelayÄrendeverktyg med MCP-server, där Claude och människan delar brädan

Varför ett eget ärendeverktyg?

Jag använde Linear för att styra arbetet med Claude Code, men jag ville ha ärendena på min egen server och kontroll över verktyget.

Innan något byggdes gick vi igenom vad vi faktiskt använde av Linear: alla 71 anrop till Linears MCP-server i sessionsloggarna, teamets statusar och etiketter och de 25 korten i ett projekt. Det var en liten del – kort, kommentarer, tre sorters relationer, statushistorik och ett projekt per repo. Nästan allt skrevs och lästes av Claude.

Relay

Relay är ett ärendeverktyg med en bräda och en lista i webbläsaren, och en MCP-server för Claude. Korten har samma sorts identifierare som i Linear (AND-55), statusar med typ, etiketter, prioritet, relationer, kommentarer och statushistorik. Verktygen i MCP-servern har Linears namn, parametrar och fältnamn, så arbetssättet som var skrivet för Linear fungerade oförändrat. Korten flyttades över från Linear, med bilderna.

Demodata: brädan för ett påhittat projekt. Varje kort visar om det är Claudes tur eller min.
Demodata: brädan för ett påhittat projekt. Varje kort visar om det är Claudes tur eller min.

Det som är byggt för att arbeta med Claude:

  • Vems tur. Varje öppet kort visar om det är Claudes tur eller människans. Det räknas fram ur etiketten – Feature är Claudes, Verifiering och Beslut är mina – och ur "väntar på svar", som försvinner när en människa kommenterar.
  • Etiketter med regler. Etikettens beskrivning är en arbetsregel som Claude läser vid varje sessionsstart.
  • get_board. Ett anrop vid sessionsstart ger öppna kort per status, etiketternas regler, vad som ändrats och nya kommentarer sedan Claude senast läste brädan.
  • Ett kort i taget per projekt för agenter. Flera Claude-sessioner kan arbeta mot samma projekt, men bara en i taget får ha ett pågående kort.
  • Skärmbilder i kommentarer, som Claude kan titta på med get_attachment.
  • Webhooks som kan väcka en Claude-session när jag kommenterar ett kort.
Demodata: startsidan med korten där det är min tur, pågående kort, de senaste korten och de mest aktiva projekten.
Demodata: startsidan med korten där det är min tur, pågående kort, de senaste korten och de mest aktiva projekten.

Kommentarerna har trådar, reaktioner och citat ur beskrivningen. Ett kort kan ha kryssrutor i beskrivningen, och ändringen sparas med ett klick. Det Claude skriver står under Claudes namn, för den person den arbetar åt.

Statusar och etiketter ställs in per team, och för varje etikett väljer man vems den är: Claudes, människans eller ingens.

Demodata: arbetsflödet med teamets prefix, statusarna med typ och etiketterna med sin ägare.
Demodata: arbetsflödet med teamets prefix, statusarna med typ och etiketterna med sin ägare.

En webhook anropar en adress när något händer på brädan. En liten mottagare på utvecklingsdatorn tar emot den bakom en tunnel, kontrollerar signaturen och startar Claude Code i rätt repo. Repot hittas genom raden i CLAUDE.md som säger vad Relay-projektet heter.

Arbetssättet står i RELAY.md, en fil som kopieras oförändrad till varje projekt: vad som bor i Relay och vad som bor i repot, vad etiketterna betyder och att Claude läser brädan vid start. Relay lämnar projekt som inte valt det i fred.

Kalender och tidslinje

Två vyer visar vad som faktiskt har gjorts, inte vad som var planerat. Båda räknar samma sak: en ändring av ett kort eller en kommentar, av en människa eller en agent. Inget datum behöver fyllas i, allt räknas ur kortens historik.

Kalendern visar en månad eller en vecka. Varje dag listar projekten som har jobbats på och deras kort, och under kalendern står periodens mest aktiva projekt med antal ändringar, kort och aktiva dagar. Den går att filtrera på bara Claude, bara människor eller ett enda projekt, och dagarna räknas i webbläsarens tidszon.

Demodata: oktober 2026 i kalenderns månadsvy, för fyra påhittade projekt. Varje dag visar projekten och korten som jobbades på.
Demodata: oktober 2026 i kalenderns månadsvy, för fyra påhittade projekt. Varje dag visar projekten och korten som jobbades på.

Ett klick på ett datum öppnar veckan, där också kortens rubriker står:

Demodata: en vecka i kalendern, med kortens rubriker och veckans mest aktiva projekt.
Demodata: en vecka i kalendern, med kortens rubriker och veckans mest aktiva projekt.

Tidslinjen visar när varje projekt har varit aktivt: en rad per projekt på en gemensam tidsaxel, med en ruta per vecka eller månad. Ju starkare färg, desto mer hände. Perioden kan vara allt från tre månader till hela historiken, och ett klick på en ruta öppnar den perioden och det projektet i kalendern.

Demodata: tidslinjen för det senaste året. Varje ruta är en vecka, och ju starkare färg, desto mer hände.
Demodata: tidslinjen för det senaste året. Varje ruta är en vecka, och ju starkare färg, desto mer hände.

Relay har också personer och agenter med egna nycklar, delade projekt, inbjudningar, favoritprojekt och textstorlek per användare. Gränssnittet finns på svenska och engelska, i ljust och mörkt läge.

Relay är byggt med Claude Code: React, Vite och TypeScript i webbläsaren, och PHP utan ramverk med MariaDB på servern. Ett test går igenom API:t och MCP-servern mot en egen tillfällig databas. Relay styrs från Relay: varje funktion efter flytten är ett kort på brädan.

På vägen

Två sessioner tog var sitt kort. En Claude-session i terminalen och en som väckts av en webhook kunde ta varsitt kort i samma projekt. Nu kontrolleras det i samma transaktion som flytten: finns redan ett kort som en agent arbetar med, nekas flytten med project_busy och vilket kort som pågår.

Claude väckte sig själv. En webhook som reagerar på alla ändringar väcker också Claude när Claude ändrar något. Förvalet är därför att bara människors ändringar skickas.

En långsam mottagare höll sidan. Webhooken skickas efter att den som ändrade fått sitt svar, men sessionen var fortfarande öppen, så sidans nästa anrop väntade på mottagaren. Nu släpps sessionen innan något skickas.

Tappad anslutning tog med sig texten. När internet försvann ersattes hela kortet av ett felmeddelande, och det man höll på att skriva försvann. Nu står sidan kvar med en rad om att anslutningen saknas, och det man skriver sparas som ett utkast i webbläsaren.

Jämfört med Linear

Linear är det jag använde innan. Det Relay ger mig:

  • ärendena på min egen server
  • samma verktygsnamn i MCP, så bytet krävde ingen ändring i arbetssättet
  • vems tur, etiketter med regler och get_board, byggda för att arbeta med Claude
  • webhooks som väcker en Claude-session
  • ett kort i taget per projekt för agenter
  • en kalender och en tidslinje över vad som faktiskt gjordes. Linear har ingen inbyggd kalender, den finns via tillägg som LinCal. Linears tidslinje är en planeringsvy för projekt, med datum och milstolpar, och visar inte enskilda kort.

Relay är inte öppet att registrera sig i.

Fler bilder:

Demodata: samma bräda i mörkt läge.
Demodata: samma bräda i mörkt läge.

Prova själv

Under Filer ligger IDEA.md: en beskrivning av verktyget och allt jag lärt mig under bygget, skriven som en uppdragsbeskrivning. Ge den i sin helhet till Claude Code så har du underlaget för ett eget ärendeverktyg för dig och Claude.