CoRoid-anslutningen är programmet som låter kodningsagenterna på din egen dator utföra arbete åt CoRoid (se Kodningsagenter på din egen dator). Den är öppen källkod enligt Apache-2.0-licensen, och hela källkoden finns på github.com/COROID-AI/coroid-connector. Den här sidan vänder sig till den som avgör om programmet får köras på organisationens datorer.
Så flödar data
Din dator
CoRoid-anslutning
Öppen källkod. Startar agenten för en arbetsomgång i en ny, tom katalog och stoppar den sedan.
Din kodagent
Agenten du använder, inloggad som du, med sina egna verktyg avstängda.
- 1Begär arbete. Varje förfrågan hålls öppen i upp till 25 sekunder; anslutningen rapporterar vad agenten säger var tredje sekund.
- 2Anropar rollens verktyg. Med en token som bara gäller för den här arbetsomgången och slutar fungera när den är slut.
- 3Skickar en fråga till sin modell. Som det skulle fungera utan CoRoid. CoRoid får aldrig tillgång till den inloggningen.
CoRoid
Orkestrerare
Fördelar en rolls arbete till datorn som tillhör personen som startade uppgiften (1).
Rollens verktyg
Körs i uppgiftens sandlåda, där din kod ligger kvar (2).
Agentens leverantör
Besvarar agentens modellförfrågningar med din egen inloggning och enligt ditt abonnemang (3).
Inget kan nå in i maskinen: anslutningen öppnar ingen port, skickar inga filer och kör inga kommandon på egen hand.
Din inloggning till agenten och det agenten själv sparar från en körning stannar på maskinen.
- Endast utgående anslutningar. Anslutningen öppnar ingen port, förutom tillfälligt på
127.0.0.1medan du loggar in. Den hämtar arbete från CoRoid via HTTPS. Varje förfrågan väntar i upp till 25 sekunder innan den skickas igen; det är också så CoRoid vet att datorn är ansluten. - Din kod stannar i CoRoid. Repot kopieras aldrig till datorn. Verktygen för rollen (läsa en fil, köra testerna, ändra koden) körs i uppgiftens sandbox i CoRoid. Det som skickas till datorn är rollens instruktioner och det verktygen returnerar, till exempel innehållet i en fil som agenten läser eller resultatet av en testkörning.
- Agentens modellförfrågningar skickas till dess leverantör, under din egen inloggning och med ditt abonnemang, precis som utan CoRoid. Det agenten skickar till sin modell omfattar det som rollens verktyg returnerat, så ditt avtal med den leverantören gäller även detta.
- Arbetet går bara till personen som startade det. En roll körs på en dator bara när uppdraget anger en agent, personen som startade uppgiften har en ansluten dator i organisationen och organisationens policy tillåter agenten. Arbete som ingen har startat, till exempel en automatisering, körs med dess modell.
Vad anslutningen gör
- Loggar in med OAuth 2.1 och PKCE i din webbläsare, med ett behörighetsomfång
(
connector.turns). Åtkomsttokenen gäller i 15 minuter och uppdateringstokenen i 30 dagar; den byts ut varje gång den används. Koppla från i Dina datorer återkallar båda. - Lagrar dessa token i macOS-nyckelringen eller Linux-skrivbordets Secret
Service och skickar dem till verktygen via standardindata, aldrig på kommandoraden. Bara om inget av detta finns lagras de i en fil som bara du kan läsa.
coroid-connector statusvisar var dina finns. - Meddelar CoRoidi den första förfrågan datorns namn, operativsystem, anslutningens egen version samt varje agents version, status och vilka modeller den erbjuder.
- Kör en tur: startar agenten i en ny, tom katalog med agentens egna verktyg avstängda, ger den en uppsättning verktyg (rollens verktyg för den turen), vidarebefordrar det den säger, avvisar alla behörighetsförfrågningar som inte är anrop till dessa verktyg och stoppar agenten. Sedan tar den bort katalogen.
Vad den inte gör
- Läser eller skickar dina filer eller kör egna kommandon. Den enda filen den läser som inte är dess egen är Cursors inställningar, för de två värden som avgör om den får använda Cursor (se Begränsningar); inget av innehållet lämnar datorn.
- Låter agenten använda sitt skal, redigera filer, söka på webben eller använda sina egna MCP-servrar och anslutningar. Varje agent startas med sin egen inställning för detta, på de agentversioner som har testats; en agent med en annan version visas i listan men används inte.
- Öppnar en port som andra kan nå eller tar emot instruktioner från någon annan än CoRoid via anslutningen den öppnat.
- Laddar ned något när den körs.
coroid-connector addinstallerar en agents adapter en gång, enbart från de paket som anges i versionens låsfil (varje paket är låst till en version och SHA-512), med installationsskript avstängda.
Förfrågningar den skickar
| Till | När | Avsikt |
|---|---|---|
CoRoids API (https://api.coroid.ai) | In- och utloggning | Registrera anslutningen, utbyta, förnya och återkalla dess token (/oauth/…) |
| CoRoids API | Medan den körs | Hämta arbete (/connector/v1/poll) och rapportera en tur (/connector/v1/turns/…/events) |
| npm-registret | Bara under coroid-connector add | Adapterpaketen som anges i versionens låsfil |
Agenten, inte anslutningen, anropar rollens verktyg (en adress under
/connector/v1/turns/, med tokenen för den turen) och sin egen leverantör.
Vad den är byggd för att tåla
| Om | Då |
|---|---|
| Någon annan försöker ansluta en dator som du | Godkännandet sker i din webbläsare när du är inloggad som du, och inloggningen slutförs bara på datorn där den startades (på 127.0.0.1, med PKCE). Godkänn bara en anslutning som du själv startade nyss. |
| Någon stjäl en anslutnings token | Tokenen ger åtkomst till ett enda behörighetsomfång: att hämta den här personens arbete och rapportera om det. Åtkomsttokenen upphör att gälla inom 15 minuter, och Koppla från återkallar båda. |
| En tokens för en tur används igen | Den fungerar bara för den turen och slutar fungera när turen avslutas. |
| En tur ber agenten göra något annat | Agentens egna verktyg är avstängda och anslutningen avvisar andra behörighetsförfrågningar. Rollens verktyg är desamma som för en molnmodell, med samma QA, granskning, grindar och stegbegränsningar. |
| En version motsvarar inte det källkoden anger | Varje version byggs av GitHub Actions från en taggad commit i det offentliga repot, förses med ett attestering och publiceras på npm med beviskedja. Homebrew-formeln tar bara in en ny version efter att ha kontrollerat dess attestering. Du kan själv kontrollera en (se nedan). |
Begränsningar
- Agenten körs som du, med din användares behörigheter på datorn. Att begränsa den till CoRoids verktyg bygger på agentens egen inställning; därför använder anslutningen bara en agentversion som har testats.
- Vad en agent sparar av en tur i sin egen lagring beror på agenten (se Vad som stannar på din dator). Organisationens policy avgör vilka agenter medarbetarna får använda (se Vad din organisation tillåter).
- Cursor frågar innan den hämtar webbinnehåll, söker på webben eller använder webbläsaren bara med standardinställningarna. Anslutningen läser två av dem på datorn (godkännandeläget och om webbsökningar godkänns automatiskt) och använder inte Cursor om inställningarna tillåter att dessa verktyg körs utan att fråga.
- Anslutningen har inte testats på Windows.
Kontrollera en version
Varje version på GitHub innehåller det publicerade paketet, anslutningsfilen, en CycloneDX-förteckning över komponenter och SHA256SUMS. Ersätt <version> med
versionen du kontrollerar.
Signaturen från npm-paketets register och beviskedjan:
mkdir check && cd check && npm init -y
npm install @coroid/connector@<version>
npm audit signaturesAttesteringen, som anger commit och arbetsflödet som byggde filen:
gh release download v<version> --repo COROID-AI/coroid-connector
gh attestation verify coroid-connector-<version>.tgz --repo COROID-AI/coroid-connector \
--signer-workflow COROID-AI/coroid-connector/.github/workflows/release.ymlFilen, som du själv bygger från den taggade källkoden:
git clone https://github.com/COROID-AI/coroid-connector && cd coroid-connector
git checkout v<version> && npm ci && npm run build
shasum -a 256 dist/coroid-connector.mjs # the same as its line in SHA256SUMSFör att rapportera en sårbarhet använder du repots säkerhetspolicy (GitHubs privata rapportering av sårbarheter).