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:
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 updateBekræ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 authdepaza whoamidepaza usageAlle betalte planer (Pro og opefter) har automatisk adgang til Code CLI. Gratis-konti kan få adgang via en invitationskode fra en admin.
depaza redeemAvanceret: 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 chatdepaza codedepaza fixdepaza reviewdepaza newdepaza initdepaza prdepaza screenshotTeam & Council
depaza teamdepaza huddledepaza solvedepaza evaldepaza 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 modelsdepaza permissionsdepaza hostsdepaza configdepaza mcp listdepaza syncInteraktiv 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.
| Holdkammerat | Rolle | Bedst til |
|---|---|---|
| 📋 Emma | Product Manager | Afklarer målet og skriver den nummererede plan — koder aldrig. |
| 🐥 Bob | Junior-udvikler | Ivrig, hurtig første implementering. |
| 🦾 Max | Senioringeniør | Arkitektur, refaktoreringer og de svære valg. |
| 🔎 Anna | QA & test | Modspilstests, 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:
| Tilstand | Opførsel |
|---|---|
| plan | Foreslå en nummereret plan og vent på godkendelse før ændringer. |
| normal | Godkend hver handling (redigering / kommando) enkeltvis. Standard. |
| yolo | Godkend 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 --allowdepaza --denydepaza permissionsTilfø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
| Sektion | Nø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
| Variabel | Formål |
|---|---|
| DEPAZA_API_KEY | Din dpz_live_…-nøgle. |
| DEPAZA_BASE_URL | Tilsidesæt API-endpointet (self-hosting). |
| DEPAZA_AUTO_APPROVE | Sæt til 1 for at godkende redigeringer og kommandoer automatisk. |
| DEPAZA_SANDBOX | Sæt til 1 for at indespærre run_bash. |
| DEPAZA_DEBUG | Sæt til 1 for at logge rå API-trafik til ~/.config/depaza/debug.log. |
| DEPAZA_LOCAL_MINI | Sæt til 1 for at aktivere on-device-mini-modellen. |
| DEPAZA_ORCHESTRATOR_MODEL / _CODER_MODEL / _VERIFIER_MODEL | Tilsidesæ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.
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 --continuedepaza --resumedepaza resumedepaza sessionsdepaza undoInde 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 --printHeadless-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 whoamidepaza updatedepaza welcomeTab-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.