Referanse · Emma

Emma

Agent-harness for Josefine, for kode og kontorarbeid. Produktflaten: /emma.

Installasjon

$npm install -g @wammer/emma

Krever Node.js 20+. Innlogging mot Wammer-konto ved første kjøring; API-nøkkel for headless-bruk.

Kommandolinje

emma

Interaktiv økt i gjeldende katalog.

emma -p "…"

Headless: én oppgave, svar på stdout, exit-kode 0/1. For skript, cron og CI.

emma --resume

Gjenopptar forrige økt i samme katalog med full kontekst.

/kommandoer

Egendefinerte kommandoer fra .emma/commands/ — per prosjekt eller bruker.

Verktøy

les / skriv / endre

Filoperasjoner. Endringer vises som diff før de skrives.

søk

Innholds- og filnavnssøk over prosjektet (regex, glob).

skall

Kjører kommandoer i prosjektets skall. Utdata logges i sin helhet.

git

Status, diff, commit, branch. Push krever egen godkjenning.

web

Henter og leser eksterne sider ved behov. Kilde-URL i loggen.

Hvert kall logges med argumenter og resultat. Loggen følger økten og kan eksporteres.

Prosjektfil

EMMA.md i prosjektroten leses ved øktstart: konvensjoner, krav og kommandoer som gjelder prosjektet. Versjonshåndteres med koden. Varig brukerminne lagres lokalt per bruker, på tvers av prosjekter.

Tillatelser

Lesing er fri. Skriv og kjør krever godkjenning; svar huskes per prosjekt som allowlist. Irreversible operasjoner (push, sletting, nettverk mot eksterne tjenester) spør alltid.

Subagenter

Emma delegerer søk, kartlegging og review til parallelle subagenter med eget kontekstvindu. Hovedøkten mottar konklusjonene. Antall og omfang styres per oppgave.

MCP

Eksterne verktøy og datakilder kobles over Model Context Protocol i .emma/mcp.json — interne API-er, databaser og fagsystemer får samme kvitteringslogg som innebygde verktøy.