De fleste "AI-agent"-veiledninger gir deg et rammeverk, en graf av noder og en helg med klipp og lim. Elyra går en stillere vei: en agent er bare en mappe og en kommando. Intet byggesteg, ingen orkestrerings-spagetti. Kan du skrive en Markdown-fil, kan du bygge en agent.
Denne guiden starter på absolutt null — du har ikke Elyra installert, du har ingen agent, du har en tom katalog og en idé. Når du er ferdig, har du en fungerende agent som bor i sitt eget hjem, husker ting og har evner du har gitt den.
Før vi tar en eneste kommando, hold fast ved dette bildet. Hver Elyra-agent er tre ting:
Harness-et er kroppen. Elyra selv er agentens kropp — løkken som leser filer, kjører kommandoer, redigerer kode, kaller modellen, sjekker resultatet og fortsetter til jobben er gjort. Du skriver ikke kroppen. Du installerer den.
Kontekstfilene er hjernen. Det agenten vet og hvem den er lever i ren Markdown — først og fremst AGENTS.md. Dette er personligheten, reglene, prosjektkunnskapen. Bytt hjerne, og den samme kroppen blir en annen agent.
Skills er de utvidede evnene. En skill er en mappe med en SKILL.md inni. Den lærer agenten å gjøre én bestemt ting — sende en e-post, hente en nettside, føre et utlegg — og agenten griper bare etter den når oppgaven faktisk krever det.
Kropp, hjerne, evner. Det er hele greia.
Bare Node.js (som gir deg npm og npx). Det er hele kravlista. Ingen Docker, ingen Python, ingen konto.
Du vil også ha en API-nøkkel fra én modell-leverandør — Anthropic, OpenAI, Google, OpenRouter og mange flere fungerer alle sammen. Vi bruker Anthropic i eksemplene, men hvilken som helst av dem går fint.
Den raskeste måten å møte Elyra på er å la npx hente og kjøre den for deg:
npx @elyracode/coding-agent
Det laster ned pakken, slipper deg inn i den interaktive agenten, og du er i gang med å snakke. Ingenting installeres permanent.
En liten, men viktig merknad: bruk det scopede navnet @elyracode/coding-agent. Et bart npx elyra peker på en annen, urelatert pakke på npm. Når du bestemmer deg for å beholde Elyra, installerer du den globalt og får din egen ryddige elyra-kommando:
npm install -g @elyracode/coding-agent
elyra
Fra nå av betyr elyra og npx @elyracode/coding-agent det samme.
Ved første kjøring trenger Elyra en leverandørnøkkel. To enkle alternativer:
# Alternativ A: miljøvariabel
export ANTHROPIC_API_KEY=sk-ant-...
elyra
# Alternativ B: logg inn fra inne i Elyra
elyra
# skriv så: /login
Uansett hvilken vei du velger, lagres legitimasjonen, så du gjør dette bare én gang. Nå har kroppen kraft. På tide å gi den et hjem.
Her er trikset som gjør Elyra-agenter rene: én mappe er hele agenten. Du forteller Elyra hvor den mappa er med en eneste miljøvariabel, ELYRA_CODING_AGENT_DIR. Alt — config, minne, økter, skills — bor inni den.
La oss bygge en liten personlig assistent som heter expense-buddy. Lag mappa og pek Elyra mot den:
mkdir -p ~/agents/expense-buddy
export ELYRA_CODING_AGENT_DIR=~/agents/expense-buddy
Vi sikter mot denne formen:
agent-home/
├── AGENTS.md # hjernen: hvem agenten er + reglene dens
├── settings.json # hvilken modell/leverandør som er standard
├── brain/
│ └── brain.md # ekstra kunnskap agenten kan lese
├── sessions/ # samtalehistorikk + rewind-checkpoints
├── skills/
│ ├── send-email/
│ │ └── SKILL.md # en evne
│ └── web-fetch/
│ └── SKILL.md # nok en evne
└── memory/
├── expenses.json # agentens egne arbeidsdata
└── facts.json
La oss fylle den ut, én del om gangen.
AGENTS.mdDette er den viktigste fila. Når Elyra starter i en mappe, laster den automatisk AGENTS.md som kontekst — ingen flagg, ingen config. Det er agentens stående instruks.
# Expense Buddy
Du er en vennlig assistent for personlig økonomi. Du hjelper med å føre
utlegg, svarer på spørsmål om forbruk og tar notater til senere.
## Regler
- Penger lever i `memory/expenses.json`. Les den før du svarer på spørsmål
om forbruk, og legg til når brukeren rapporterer et nytt utlegg.
- Varige fakta om brukeren går i `memory/facts.json`.
- Bakgrunnskunnskap lever i `brain/brain.md` — les den når du trenger
kontekst om kategorier, budsjetter eller konvensjoner.
- Vær konsis. Bekreft hva du lagret.
Legg merke til hva som skjer: hjernen inneholder ikke all kunnskapen, den forteller agenten hvor den skal lete og hvordan den skal oppføre seg. Det holder den alltid-lastede konteksten liten og rask.
settings.jsonEn liten fil som velger standardmodellen, så du slipper å sende flagg hver gang:
{
"defaultProvider": "anthropic",
"defaultModel": "claude-opus-4-8",
"defaultThinkingLevel": "medium"
}
Det er alt. Leverandør, modell, hvor hardt den skal tenke som standard.
brain/brain.mdAGENTS.md lastes hver tur, så du holder den slank. Alt som er tyngre — referansemateriale, kategoridefinisjoner, en stilguide — går i filer agenten leser ved behov. Her, brain/brain.md:
# Utleggskunnskap
## Kategorier
- dagligvarer, restaurant, transport, strøm, abonnementer, annet
## Budsjetter (månedlig)
- dagligvarer: 4000 kr
- restaurant: 1500 kr
Når en kategori er tvetydig, spør før du gjetter.
Agenten henter dette inn bare når det er relevant, fordi AGENTS.md ba den om det.
skills/En skill er en mappe som inneholder en SKILL.md. Fila starter med litt YAML-frontmatter — et name og en description — og deretter instruksjonene. Elyra viser modellen bare navnet og beskrivelsen av hver skill; når en oppgave matcher, åpner agenten hele fila og følger den. Billig å ha liggende, kraftig når det trengs.
skills/send-email/SKILL.md:
---
name: send-email
description: Send an email via the local mail command. Use when the user
asks to email a summary, report, or reminder.
---
# Send en e-post
1. Skriv et kort, tydelig emne og en kort tekst.
2. Kjør: `printf '%s' "$BODY" | mail -s "$SUBJECT" "$RECIPIENT"`
3. Bekreft overfor brukeren hva som ble sendt og til hvem.
skills/web-fetch/SKILL.md:
---
name: web-fetch
description: Fetch a URL and extract readable text. Use when the user asks
about the contents of a web page or a live document.
---
# Hent en nettside
1. Kjør `curl -fsSL "$URL"` for å hente siden.
2. Oppsummer de relevante delene for brukeren. Ikke dump rå HTML.
Du kan slippe en scripts/- eller references/-mappe ved siden av en SKILL.md og referere til dem fra instruksjonene — perfekt for lengre hjelpeskript. Skills er hvordan en generisk kropp blir en spesialist uten å blåse opp hjernen.
memory/Dette er agentens egen kladdeblokk — filer den leser og skriver med sine vanlige verktøy mens den jobber. For Expense Buddy er det expenses.json og facts.json. Start dem tomme:
mkdir -p ~/agents/expense-buddy/memory
echo '[]' > ~/agents/expense-buddy/memory/expenses.json
echo '{}' > ~/agents/expense-buddy/memory/facts.json
Fordi AGENTS.md fortalte agenten at disse filene finnes og hva de er til for, leser og oppdaterer den dem på egen hånd. (Elyra holder også sitt eget minne på øktnivå her automatisk — men agentens arbeidsdata er bare filer den eier.)
sessions/Denne lager du ikke — Elyra gjør det. Hver samtale lagres her som et checkpoint, og det er det som driver /rewind (rull tilbake både chatten og filene) og --continue (plukk opp der du slapp). Det er agentens episodiske minne, og det kommer gratis.
Alt er på plass. Gå inn i hjem-mappa og start:
cd ~/agents/expense-buddy
npx @elyracode/coding-agent
Fordi mappa er både arbeidskatalog og det konfigurerte agent-hjemmet, laster Elyra hjernen (AGENTS.md), standardmodellen (settings.json) og evnene (skills/) på én gang. Snakk så med den:
> Jeg brukte 240 kr på dagligvarer i dag og 95 på lunsj.
Leser memory/expenses.json...
Legger til 2 oppføringer (dagligvarer 240, restaurant 95)
Lagret. Du er på 240/4000 på dagligvarer og 95/1500 på restaurant denne måneden.
> Send meg en oppsummering av denne ukas forbruk.
Matcher skill: send-email
Leser memory/expenses.json...
Setter sammen oppsummering... sender til deg@example.com
Ferdig. Sendte "Ditt ukentlige forbruk" med oversikten.
Kroppen leste og skrev filer, hjernen fortalte den hvor og hvordan, og en skill ga den en evne den ikke ble født med. Det er en komplett agent.
Du gikk fra en tom mappe til en fungerende agent med fem bevegelige deler:
Del Fil(er) Rolle Kropp Elyra selv Løkken som gjør jobben Hjerne AGENTS.md, brain/brain.md Hvem den er, hva den vet Config settings.json Standard modell og leverandør Evner skills/*/SKILL.md Spesialiserte skills ved behov Minne memory/, sessions/ Dataene dens og historikken
Og hele oppsettet er bare:
npm install -g @elyracode/coding-agent # installer kroppen
export ELYRA_CODING_AGENT_DIR=~/agents/my-agent # pek på hjemmet
cd ~/agents/my-agent && elyra # vekk den
Intet rammeverk, intet bygg, ingen innlåsing. Skriv en Markdown-hjerne, legg til en skill eller to, og du har en agent som er din — versjonert i en mappe, lett å lese, lett å dele.
Elyra