Larin och ledgerctl — kommandoreferens

[2026-07-24 Fri]

Larin CLI

larin är den användarvänliga terminalkonsumenten. Utdata är avsedd för människor; använd ledgerctl --format json för stabil maskinintegration.

Kommando	Användning
`larin --version` eller `larin -V`	Visa releaseversion och byggidentitet utan arbetsyta
`larin` eller `larin menu`	Interaktiv prompt med TAB-komplettering
`larin bootstrap CSV [DIR]`	Preview/apply för komplett ny arbetsyta med öppningssaldo
`larin status`, `larin budget` eller `larin budget status`	Visa kuvertbudget
`larin insights [flaggor]`	Visa vart pengarna gick; alias `översikt`
`larin purchase [flaggor]`	Preview/apply för köp; alias `köp`
`larin doctor` eller `larin budget doctor`	Visa Budget Doctor
`larin merchants`	Lista merchants
`larin merchant list`	Lista merchants; alias `handlare lista`
`larin merchant add [flaggor]`	Skapa merchant via admin-API
`larin envelopes`	Lista kuvert
`larin envelope list`	Lista kuvert; alias `kuvert lista`
`larin envelope add [flaggor]`	Skapa kuvert via Envelope API
`larin envelope update ID [flaggor]`	Ändra namn eller kontomappningar via Envelope API

Globala flaggor:

Flagga	Betydelse
`--workspace KATALOG`	Katalog som innehåller `ledgerctl.conf`
`--ledgerctl PROGRAM`	Explicit sökväg till `ledgerctl`
`--version`, `-V`	Visa version genom ledgerctls JSON-kontrakt och avsluta

Larin purchase

larin purchase
larin purchase --merchant ica --amount 243,50 [flaggor]

Flagga	Betydelse
`--merchant IDENTITET`	Merchant-id, shortcut eller exakt namn
`--amount BELOPP`	Positivt köpbelopp
`--date ÅÅÅÅ-MM-DD`	Datum; standard är idag
`--note TEXT`	Valfri anteckning
`--cleared`	Cleared i stället för pending
`--preview-only`	Visa preview och skriv aldrig
`--yes`	Verkställ visad preview utan en andra fråga

Larin merchant add

larin merchant add --name NAMN --category expenses:KONTO [flaggor]

Flagga	Betydelse
`--name NAMN`	Visningsnamn
`--category KONTO`	Standardkonto under `expenses:`
`--id MERCHANT-ID`	Permanent merchant-id
`--alias TEXT`	Bankalias; kan upprepas
`--shortcut KOD`	Mänsklig kortkod; kan upprepas
`--country LAND`	Tvåställig landskod
`--website URL`	Valfri webbplats
`--notes TEXT`	Valfri anteckning
`--preview-only`	Visa preview och skriv aldrig
`--yes`	Verkställ visad preview utan en andra fråga

Larin envelope add

larin kuvert add --label NAMN --id ID --account expenses:KONTO [flaggor]

Flagga	Betydelse
`--label NAMN`	Kuvertets visningsnamn
`--id ID`	Permanent kuvert-id
`--account KONTO`	Expense-konto; kan upprepas
`--preview-only`	Visa preview och skriv aldrig
`--yes`	Verkställ visad preview utan en andra fråga

Larin envelope update

larin envelope update ID \
  [--label NAMN] \
  [--add-account expenses:KONTO] \
  [--remove-account expenses:KONTO] \
  [--preview-only] [--yes]

Minst en ändring måste anges. Konto-flaggorna kan upprepas. Ledgerctl staged- validerar både envelopes.conf och den regenererade auto.journal innan ändringen kan verkställas.

ledgerctl huvudkommandon

Kommando	Användning
`ledgerctl --version` eller `ledgerctl -V`	Visa releaseversion och byggidentitet utan arbetsyta
`ledgerctl version [--format json]`	Samma versionsinformation som människa eller JSON
`ledgerctl bootstrap CSV [DIR]`	Härled öppningssaldo och skapa komplett arbetsyta
`ledgerctl init [--with-seed] [DIR]`	Skapa enkel arbetsyta utan öppningssaldo
`ledgerctl import [CSV] [flaggor]`	Importera bank-CSV till `finance.journal`
`ledgerctl add [MERCHANT] [BELOPP] [flaggor]`	Registrera köp via Purchase API
`ledgerctl audit [CSV]`	Audit av routes mot journal eller okända mottagare i CSV
`ledgerctl suggest-routes [CSV]`	Lär in mottagare interaktivt
`ledgerctl suggest-envelopes [flaggor]`	Tilldela otäckta expense-konton atomiskt till kuvert
`ledgerctl reconcile [CSV]`	hLedger-kontroll eller kontroll av CSV:s löpande saldo
`ledgerctl report VY [period]`	Rapportera från journalen
`ledgerctl stats`	Genväg till `report stats`
`ledgerctl archive YYYY [flaggor]`	Dry-run eller försegla ett år
`ledgerctl verify ARKIV [flaggor]`	Verifiera manifest, signatur och anchor
`ledgerctl budget ...`	Kuvertbudget
`ledgerctl budget coverage`	Kontrollera att alla utgifter har exakt ett kuvert
`ledgerctl workspace revision`	Visa gemensam workspace-revision
`ledgerctl merchant ...`	Lista, visa och skapa merchant via JSON API
`ledgerctl purchase create ...`	Maskinläsbart köp-API med preview/apply
`ledgerctl budget envelope list`	Lista kuvert via JSON/API
`ledgerctl budget envelope create`	Preview/apply för nytt kuvert
`ledgerctl budget envelope update`	Preview/apply för namn och kontomappningar
`ledgerctl budget envelope organize`	Atomisk batch-preview/apply för flera kuvert
`ledgerctl doctor`	Grundläggande miljökontroll
`ledgerctl config ...`	Visa eller redigera konfiguration
`ledgerctl fff`	Interaktiv CSV-väljare och import

Bootstrap

ledgerctl bootstrap CSV-FIL [NY-ARBETSYTA] [flaggor]

Preview är standard. Operationen skapar inte en halv arbetsyta: apply bygger allt i en temporär katalog, validerar med en stödd hledger-version och publicerar sedan katalogen atomiskt.

Flagga	Betydelse
`--bank NAMN`	Bankparser; standard `auto`
`--bankaccount KONTO`	Välj exakt kontonummer när CSV:n innehåller flera
`--currency VALUTA`	Kräv uttryckligen denna valuta
`--asset-account KONTO`	Bankens hledger-konto
`--equity-account KONTO`	Motkonto för öppningsbalansen
`--no-seed`	Skapa tom merchant-databas
`--format table\|json`	Människo- eller maskinutdata
`--apply`	Verkställ den granskade planen
`--preview-digest SHA256`	Krävs tillsammans med `--apply`

Transaktionerna i CSV-filen importeras inte av bootstrap. Filen kopieras till imports/ och går därefter genom vanlig audit, routing och import.

Larin insights

larin insights [--month ÅÅÅÅ-MM] [--months 1-60]

Flagga	Betydelse
`--month ÅÅÅÅ-MM`	Månad att analysera; standard aktuell månad
`--months ANTAL`	Trendfönster och historiskt underlag; standard 12

Kommandot visar totalsummor, kuvert, merchants, månadstrend, jämförelser, köpintervall och återkommande betalningsmönster. Stabil månadsrytm markeras som en kandidat för granskning; Larin påstår inte automatiskt att betalningen är ett abonnemang eller en fast kostnad.

Init

ledgerctl init [--with-seed] [DIR]

--with-seed: skapa startdata i merchant-db.json när båda är tomma.

Import

ledgerctl import [CSV-FIL] [flaggor]

Flagga	Betydelse
`--daily`	Dagliga saldoassertions
`--reconcile`	Strikt reconcile-rapport i importflödet
`--all`	Båda ovanstående
`--bankaccount KONTO`	Välj exakt kontonummer ur CSV
`--yes`, `-y`	Hoppa över bekräftelse

Add

ledgerctl add [MERCHANT] [BELOPP] [flaggor]

Kommandot är en mänsklig preview/apply-adapter ovanpå Purchase API:t. MERCHANT får vara shortcut, exakt namn eller merchant-id.

Flagga	Betydelse
`--category KONTO`	Överstyr standardkategori för detta köp
`--date ÅÅÅÅ-MM-DD`	Välj datum
`--note TEXT`	Narration/kommentar
`--cleared`	Registrera `*` i stället för `!`
`--idempotency-key NYCKEL`	Stabil nyckel för säker retry
`--yes`, `-y`	Bekräfta `possible_duplicate`
`--dry-run`	Visa Purchase API-preview utan skrivning

Merchant API v2

ledgerctl merchant list [--format table|json]
ledgerctl merchant show MERCHANT-ID [--format table|json]
ledgerctl merchant create --input-json FIL|- [--format table|json]
ledgerctl merchant create --input-json FIL|- --apply \
  --expected-revision REV [--format table|json]
ledgerctl merchant update MERCHANT-ID --input-json FIL|- [--format table|json]
ledgerctl merchant update MERCHANT-ID --input-json FIL|- --apply \
  --expected-revision REV [--format table|json]
ledgerctl merchant add-alias MERCHANT-ID --input-json FIL|- [--format table|json]
ledgerctl merchant add-shortcut MERCHANT-ID --input-json FIL|- [--format table|json]

Alla skrivoperationer är preview som standard. Apply kräver --expected-revision. Databasen är en enda merchant-db.json med schema_version: 2. Varje merchant äger två separata listor:

aliases: bankens mottagarsträngar för import och matchning,
shortcuts: mänskliga kortkoder för ledgerctl add och formulär.

create kan lägga in merchant, aliases och shortcuts atomiskt. update ändrar profilfält som namn, standardkonto, land, webbplats och anteckning men lämnar alias och shortcuts orörda. add-alias och add-shortcut utökar en befintlig merchant utan att blanda ihop de två identitetsdomänerna.

Purchase API: lista och klassificera om

ledgerctl purchase list [--needs-attention] [--period ÅÅÅÅ-MM] [--format table|json]
ledgerctl purchase reclassify --input-json FIL|- [--format table|json]
ledgerctl purchase reclassify --input-json FIL|- --apply \
  --expected-revision REV [--format table|json]

purchase list visar manuella köp som skapats av Purchase API:t. Med --needs-attention begränsas resultatet till köp som ligger i reservkuvertet Att kategorisera eller vars konto inte matchar exakt ett kuvert.

reclassify ändrar endast utgiftskontot i den identifierade manuella posten. Previewn returnerar request_digest, före-/efterkonto, kuvertmatchning och journalblock. Apply kräver både samma digest och --expected-revision.

Audit och suggest-routes

ledgerctl audit
ledgerctl audit CSV-FIL
ledgerctl suggest-routes [CSV-FIL] [--merchant-db FIL]

suggest-routes kräver interaktiv terminal för full TAB-komplettering.

Suggest-envelopes

ledgerctl suggest-envelopes [--scope routes|all] [--preview-only] [--yes]

Flagga	Betydelse
`--scope routes`	Granska konton från `routes.conf`; standard
`--scope all`	Ta även med merchantkonton och journalposter
`--preview-only`	Bygg och validera planen men skriv aldrig
`--yes`	Verkställ den färdiga previewn utan sista fråga

Kommandot kräver interaktiv terminal för full TAB-komplettering. Alla beslut samlas och skickas som en enda budget envelope organize-mutation.

Reconcile

ledgerctl reconcile
ledgerctl reconcile CSV-FIL

Utan CSV kontrolleras journalen. Med CSV kontrolleras bankfilens löpande saldo utan import.

Report

ledgerctl report VY [--month ÅÅÅÅ-MM | --from DATUM [--to DATUM]]

Vyer:

bal bal-tree reg reg20 is es bs cf accounts payees tags
unknown uncategorized today yesterday month year check stats

Flagga	Betydelse
`--commit`	Utför; utan flaggan endast dry-run
`--sign [KEYID]`	GPG-signera manifestet
`--only-local`	Lokal Git-anchor utan push
`--no-anchor`	Hoppa över anchoring
`--push-to REMOTE`	Välj remote eller URL
`--anchor-dir DIR`	Välj lokalt anchor-repo
`--snapshot FIL`	Egen snapshotfil; kan upprepas och ersätter standarduppsättningen

Verify

ledgerctl verify ARKIV-KATALOG [flaggor]

Flagga	Betydelse
`--require-signature`	Signatur måste finnas och verifieras
`--signer FINGERPRINT`	Kräv viss signerare; implicerar signaturkrav
`--anchor`	Jämför manifestet mot anchor-repot
`--anchor-dir DIR`	Välj anchor-repo

Budget: init och generering

ledgerctl budget init [--asset-account KONTO] [--currency VALUTA]
                      [--template FIL] [--no-bootstrap] [--force]
ledgerctl budget regen-auto

Budget: läsning

ledgerctl budget status [--month ÅÅÅÅ-MM] [--format table|json] [--no-averages]
ledgerctl budget history KUVERT [--month ÅÅÅÅ-MM] [--months 1-60]
                                  [--format table|json]
ledgerctl budget analytics KUVERT [--month ÅÅÅÅ-MM] [--months 1-60]
                                    [--format table|json]
ledgerctl budget insights [--month ÅÅÅÅ-MM] [--months 1-60]
                          [--format table|json]
ledgerctl budget coverage [--scope routes|all] [--format table|json]
ledgerctl budget check
ledgerctl budget doctor [--format table|json]

budget coverage verifierar kuverttäckningsinvarianten. --scope routes är den snabba, skrivskyddade kontroll som importen kör före en bankimport. --scope all kontrollerar dessutom merchantstandardkonton och verkliga journalposter. Fel betyder att ett expenses:*-konto matchar noll eller flera kuvert. Merchantproblem som ännu inte förekommer i journalen rapporteras som varningar; verkliga journalposter utan entydigt kuvert är fel.

Budgetimporten kräver reservkuvertet. Okända utgifter får då importeras till expenses:uncategorized för senare kategorisering; okända inkomster blockeras fortfarande:

[envelope uncategorized]
label = Att kategorisera
accounts = expenses:uncategorized

Om en route pekar på ett konto utan kuvert stoppar importen innan CSV:n konverteras eller någon journalfil skrivs. Terminalrapporten listar befintliga kuvert och visar körbara exempel, bland annat:

larin envelope update KUVERT-ID --add-account expenses:restaurants
larin envelope add --label "Bank Fees" --id bank-fees \
  --account expenses:bank-fees
ledgerctl budget coverage --scope routes

För många otäckta kategorier är den interaktiva assistenten snabbare:

ledgerctl suggest-envelopes
ledgerctl suggest-envelopes --scope all
ledgerctl suggest-envelopes --preview-only

Assistenten rankar befintliga kuvert genom mekaniska träffar mot kuvert-ID, namn och kontohierarki. TAB kompletterar kuvert-ID och etiketter. För varje kategori väljer användaren befintligt kuvert, nytt kuvert eller att hoppa över. Exakt konto är standard; en bredare säker föräldrarot kan väljas efter en extra bekräftelse. Hela planen staged-valideras tillsammans, visas som en samlad preview och skrivs först efter en avslutande fråga. envelopes.conf och auto.journal publiceras som en enda revisions- och digest-skyddad mutation.

Alla budgetmutationer blockeras medan en verklig utgift saknar entydig kuverttäckning. Rätta då kontot eller envelopes.conf och kör budget doctor eller budget coverage igen.

Budget: fund

ledgerctl budget fund KUVERT BELOPP
  [--date ÅÅÅÅ-MM-DD]
  [--allow-noncurrent]
  [--yes]
  [--expected-revision REV]
  [--apply]
  [--format table|json]

Budget: move

ledgerctl budget move FRÅN TILL BELOPP
  [--month ÅÅÅÅ-MM]
  [--date ÅÅÅÅ-MM-DD]
  [--allow-noncurrent]
  [--expected-revision REV]
  [--apply]
  [--format table|json]

Budget: set-budget

ledgerctl budget set-budget KUVERT BELOPP
  [--month ÅÅÅÅ-MM]
  [--date ÅÅÅÅ-MM-DD]
  [--allow-noncurrent]
  [--expected-revision REV]
  [--apply]
  [--format table|json]

Budget: mirror

ledgerctl budget mirror
  [--envelope KUVERT]
  [--note TEXT]
  [--date ÅÅÅÅ-MM-DD]
  [--allow-noncurrent]
  [--expected-revision REV]
  [--apply]
  [--format table|json]

Budget: sweep-month

ledgerctl budget sweep-month
  [--force]
  [--date ÅÅÅÅ-MM-DD]
  [--allow-noncurrent]
  [--expected-revision REV]
  [--apply]
  [--format table|json]

Config

ledgerctl config show
ledgerctl config path
ledgerctl config edit
ledgerctl config init

ledgerctl config init skapar endast en configfil. För en komplett arbetsyta används ledgerctl init.

Hjälp

larin --help
larin purchase --help
larin merchant add --help
larin kuvert add --help

ledgerctl help
ledgerctl KOMMANDO --help
ledgerctl budget KOMMANDO --help