← CLI-oversigt

Manual

Depaza Code CLI-manual

Alt hvad CLI'en kan — installation, login, alle kommandoer, den interaktive session, teamet, konfiguration og fejlfinding.

Dækker depaza v0.27.0 · kør depaza --help for den samme reference offline.

Installation & opdatering

Depaza Code CLI er en Python-pakke (depaza-cli, kommandoen depaza) og kræver Python 3.10 eller nyere. Installér den én gang, globalt:

# Anbefalet — isoleret, global (kræver pipx)
$ pipx install depaza-cli
 
# Én-linjes installer (foretrækker pipx, falder pænt tilbage)
$ curl -fsSL https://depaza.com/install.sh | bash
 
# Eller med uv (hurtigst)
$ uv tool install depaza-cli

CLI'en tjekker for en ny version i baggrunden ved opstart (højst én gang om dagen, ikke-blokerende). Opdatér manuelt når som helst:

depaza update
Tjek for og installér den nyeste version. · e.g. depaza update --check

Bekræft med depaza --version. Slå tab-fuldførelse til i shellen med depaza --install-completion, og genstart derefter din shell.

Login & tidlig adgang

Forbind terminalen til din Depaza-konto én gang. depaza auth åbner din browser, du godkender enheden, og nøglen skrives til ~/.config/depaza/config.toml (filtilstand 0600).

depaza auth
Forbind denne terminal til din konto (åbner browseren). · e.g. depaza auth --no-browser
depaza whoami
Vis den aktuelle forbindelse og kontostatus.
depaza usage
Vis dine plangrænser og resterende kredit.

Alle betalte planer (Pro og opefter) har automatisk adgang til Code CLI. Gratis-konti kan få adgang via en invitationskode fra en admin.

depaza redeem
Indløs en invitationskode for at låse op for tidlig adgang. · e.g. depaza redeem JANNIK

Avanceret: indsæt en nøgle non-interaktivt med depaza auth --key dpz_live_…, eller sæt DEPAZA_API_KEY i miljøet (nyttigt i CI).

Kommandoer

Kør depaza uden argumenter for at åbne den interaktive session, eller brug en one-shot-kommando. Kodekommandoer accepterer --model / -m <lite|core|max> og --auto / -y (godkend redigeringer og kommandoer automatisk).

Kodning

depaza chat
Kod med Depaza — interaktivt, eller one-shot hvis du giver en prompt. · e.g. depaza chat "tilføj et /health-endpoint"
depaza code
Implementér eller forklar kode i ét hug. · e.g. depaza code "tilføj paginering til /users"
depaza fix
Find grundårsagen til en fejl, ret den, og verificér. · e.g. depaza fix "tests i test_auth fejler"
depaza review
Skrivebeskyttet gennemgang for korrekthed og GDPR. Tilføj --pr N for en GitHub-PR. · e.g. depaza review src/auth.py
depaza new
Stillads et nyt projekt eller en feature. · e.g. depaza new "FastAPI-service med i18n"
depaza init
Guide der skriver en DEPAZA.md med dine projektkonventioner.
depaza pr
Udkast til en PR ud fra branch-diffen, og åbn den med gh. · e.g. depaza pr --base main
depaza screenshot
Byg en UI ud fra et screenshot, finpudset til den matcher. Brug --paste til udklipsholderen. · e.g. depaza screenshot ui.png --rounds 3

Team & Council

depaza team
Mød teamet — Emma, Bob, Max & Anna.
depaza huddle
Emma, Max & Anna analyserer et emne parallelt (skrivebeskyttet) og samler det.
depaza solve
Council'et — løs en opgave med et dekorreleret ensemble, valgt af tests. · e.g. depaza solve "RPN-evaluator" -t test_rpn.py
depaza eval
Kør den kuraterede eval-suite gennem Council'et og giv den score. · e.g. depaza eval --baseline core

depaza solve skriver til solution.py som standard (-o), forfatter et pytest-orakel hvis du udelader -t, og kører 2–5 Council-medlemmer (-n, standard 4).

Konto & system

depaza models
Vis strategien for multi-model-orkestrering.
depaza permissions
Vis de gældende tilladelsesregler (allow/deny).
depaza hosts
Vis SSH-hosts (fra ~/.ssh/config) som agenten kan bruge til fjernhandlinger.
depaza config
Åbn den interaktive konfigurations-UI.
depaza mcp list
Vis konfigurerede MCP-servere og deres værktøjer.
depaza sync
Synkronisér sessioner til dit dashboard — on, off eller status. · e.g. depaza sync status

Interaktiv session & slash-kommandoer

Kør depaza (eller depaza chat) for at åbne sessionen. Skriv naturligt for at give teamet arbejde; det læser og søger i filer, laver præcise redigeringer og kører kommandoer, og verificerer så sine egne ændringer. Tryk Shift+Tab for at skifte godkendelsestilstanden i værktøjslinjen.

Tiltal en holdkammerat ved navn for en direkte forespørgsel — Emma, planlæg billing-flowet, Bob, implementér det, Anna, gennemgå det her, Max, tjek arkitekturen — eller sig Team, … for at køre hele pipelinen (Emma planlægger → Bob bygger → Anna gennemgår).

Slash-kommandoer — skriv / for fuldførelse:

/helpVis alle kommandoer.
/teamMød teamet / kør hele pipelinen.
/emma📋 Planlæg det (PM — koder aldrig).
/bob🐥 Hurtig første implementering.
/max🦾 Senior: arkitektur & svære valg.
/anna🔎 QA: tests, edge cases, GDPR.
/huddleHele teamet analyserer parallelt og samler det.
/pasteLæs et screenshot fra udklipsholderen.
/modelSkift model (lite | core | max).
/planPlan-tilstand — godkend før kodning.
/normalGodkend hver handling.
/yoloIngen godkendelser.
/modeSkift plan → normal → yolo.
/diffVis ikke-committede git-ændringer.
/undoFortryd de seneste filændringer.
/rewindFortryd de seneste n ture (filer + chat).
/compactSkrump samtalekonteksten.
/memoryVis teamets gemte erfaringer.
/rememberGem en erfaring til fremtidige kørsler.
/resumeGenoptag en tidligere session.
/usagePlangrænser + forbrug.
/costSessionsstørrelse + planforbrug.
/exportSkriv et markdown-transkript af sessionen.
/configÅbn konfigurations-UI'en.
/clearStart en frisk samtale.
/exitAfslut.

Teamet

Depaza er ikke én model — det er et lille team, hvor hver kører den EU-hostede tier, der passer til jobbet. Tilkald dem ved navn i en session eller med den tilsvarende slash-kommando.

HoldkammeratRolleBedst til
📋 EmmaProduct ManagerAfklarer målet og skriver den nummererede plan — koder aldrig.
🐥 BobJunior-udviklerIvrig, hurtig første implementering.
🦾 MaxSenioringeniørArkitektur, refaktoreringer og de svære valg.
🔎 AnnaQA & testModspilstests, edge cases, GDPR — skrivebeskyttet vagthund.

Kør depaza team for at se hvilken model hver holdkammerat er på. depaza models viser orchestrator / coder / verifier-strategien og hvordan du tilsidesætter en rolle.

Godkendelsestilstande & tilladelser

Hver filændring og kommando beder om godkendelse — med en diff eller kommando-forhåndsvisning — medmindre du fravælger det. Tre tilstande, skiftet live med Shift+Tab eller slash-kommandoerne:

TilstandOpførsel
planForeslå en nummereret plan og vent på godkendelse før ændringer.
normalGodkend hver handling (redigering / kommando) enkeltvis. Standard.
yoloGodkend alt automatisk resten af sessionen.

Start en kørsel uovervåget med --yolo (eller pr. kommando --auto / -y), eller planlæg på forhånd med --plan. Ved enhver godkendelsesprompt kan du skrive yolo for at skifte resten af sessionen.

Tilladelsesregler giver finkornet kontrol. En regel er et værktøjsnavn med et valgfrit glob — edit_file, run_bash(git *), write_file(/etc/*), mcp__*. Deny vinder altid.

depaza --allow
Tillad en regel automatisk (kan gentages). · e.g. depaza --allow 'run_bash(git *)' chat
depaza --deny
Afvis en regel (kan gentages). · e.g. depaza --deny 'run_bash(rm *)' chat
depaza permissions
Vis de gældende regler.

Tilføj --sandbox for at indespærre run_bash (ingen netværk; skrivninger begrænset til projektet), hvor OS'et understøtter det. Agentens værktøjer spænder over skrivebeskyttede (read_file, list_dir, glob, grep, web_search), muterende (write_file, edit_file, run_bash) og fjernhandlinger (ssh_run, scp_upload / scp_download, rsync_sync) via dine ~/.ssh/config-host-aliasser.

Konfiguration

Indstillinger ligger i ~/.config/depaza/config.toml (tilstand 0600). Redigér den med den interaktive UI — depaza config — eller i hånden. Miljøvariabler tilsidesætter filen, hvilket er nyttigt i CI.

config.toml-sektioner

SektionNøgler
[auth]api_key, base_url (standard https://depaza.com/v1)
[preferences]default_model (lite | core | max, standard core)
[permissions]auto_approve, sandbox
[roles]orchestrator_model, coder_model, verifier_model
[local]mini_enabled, model_path, model_url (valgfri on-device-model)
[sync]enabled (upload sessioner til EU-dashboardet)

Miljøvariabler

VariabelFormål
DEPAZA_API_KEYDin dpz_live_…-nøgle.
DEPAZA_BASE_URLTilsidesæt API-endpointet (self-hosting).
DEPAZA_AUTO_APPROVESæt til 1 for at godkende redigeringer og kommandoer automatisk.
DEPAZA_SANDBOXSæt til 1 for at indespærre run_bash.
DEPAZA_DEBUGSæt til 1 for at logge rå API-trafik til ~/.config/depaza/debug.log.
DEPAZA_LOCAL_MINISæt til 1 for at aktivere on-device-mini-modellen.
DEPAZA_ORCHESTRATOR_MODEL / _CODER_MODEL / _VERIFIER_MODELTilsidesæt model-tier for en rolle.

Depaza bruger open source LLM'er. Du kan køre CLI'en med dine egne lokale open-modeller (Ollama, vLLM eller Depaza's lokale optimerede) eller vores EU-hostede versioner. Agent-team og orchestration er det samme. Se aktive tiers med depaza models. Brug --no-orchestrator for at bruge én model.

Egne kommandoer & MCP

Egne slash-kommandoer. Læg en markdown-fil i ~/.config/depaza/commands/<navn>.md (bruger-niveau) eller ./.depaza/commands/<navn>.md (projekt-niveau, vinder ved konflikt) for at tilføje din egen /<navn>. Valgfri YAML-front-matter sætter en description:; brødteksten er prompten, hvor $ARGUMENTS erstattes af det, du skriver efter kommandoen.

# ~/.config/depaza/commands/ship.md
$ ---
$ description: Kør tests, åbn så en PR
$ ---
$ Kør testsuiten. Hvis grøn, åbn en PR med depaza pr. $ARGUMENTS

MCP-servere. Forbind eksterne værktøjer via Model Context Protocol. Konfigurér servere i ~/.config/depaza/mcp.json eller ./.depaza/mcp.json, og vis dem med depaza mcp list. MCP-værktøjer fremstår for agenten som mcp__<server>__<tool> og følger de samme tilladelsesregler.

Projektkonventioner. En DEPAZA.md (den læser også AGENTS.md / CLAUDE.md) i roden af dit repo indlæses i hver session. Generér en med depaza init.

Sessioner, fortryd & headless

Sessioner gemmes automatisk. Genoptag den seneste i denne mappe, eller vælg blandt de sidste ti:

depaza --continue
Genoptag den seneste session i denne mappe. · e.g. depaza -c
depaza --resume
Genoptag en session via id (fra depaza sessions eller dashboardet). · e.g. depaza --resume <id>
depaza resume
Vælg en af dine sidste 10 sessioner og fortsæt den.
depaza sessions
Vis eller ryd gemte samtaler. · e.g. depaza sessions --clear
depaza undo
Fortryd det seneste sæt filændringer, Depaza lavede.

Inde i en session fortryder /rewind de seneste par ture (filer og chat samlet), og /undo ruller de seneste redigeringer tilbage.

Isoleret & headless. Brug --worktree for at køre i et midlertidigt git-worktree og gennemgå/flette ved afslutning. Til scripts og CI, kør headless:

depaza --print
Kør én prompt, udskriv resultatet, og afslut. · e.g. depaza -p "opsummer diffen" --output-format json

Headless-outputformater er text (standard), json og stream-json. Muterende værktøjer forbliver afvist i headless, medmindre du giver en --allow-regel eller --yolo. Tilføj --transcript <sti> for at skrive et fuldt markdown-spor af ræsonnement/værktøjer.

Fejlfinding & hjælp

Noget galt? Kør med --debug (eller sæt DEPAZA_DEBUG=1) for at logge rå API-forespørgsler og -svar til ~/.config/depaza/debug.log.

depaza whoami
Bekræft at du er forbundet og på den rigtige plan.
depaza update
Sørg for at du er på den nyeste version.
depaza welcome
Vis velkomst-/hvad-gør-Depaza-anderledes-skærmen igen.

Tab-fuldførelse virker ikke? Kør depaza --install-completion og genstart din shell. Lokal konfiguration ligger under ~/.config/depaza/ — fjern config.toml for at starte forfra, og kør så depaza auth igen.

Operatører har en server-gated depaza admin-kommandogruppe (statistik, brugere, planer, omkostninger og søgeadministration). Den er begrænset til super-admin-listen og er uden for denne manuals scope.

Brug for hjælp? Kør depaza help for brandede eksempler, eller kontakt os via CLI-oversigten og dit dashboard.

Kom i gang

Sæt hele teamet i arbejde i dag

Emma, Bob, Max og Anna er klar i din terminal — EU First, EU-hostet og GDPR-klar. Vælg en plan og forbind på under et minut.

Betalte planer (Pro+) får automatisk Code CLI-adgang — kør bare depaza auth.

Denne manual afspejler depaza --help. CLI'en og alle dens modeller kører inde i EU.