Deck ma trzy bramy. Każdy skill instaluje też skrót vc-<skill> — cienki wrapper, który przekazuje argv w całości.
vibecrafted <command> [args] # komenda decka (init, doctor, server…) vibecrafted <skill> <agent> [-p <prompt> | -f <file>] # workflow z agentem zewnętrznym vibecrafted <agent> <mode> <plan.md> # tryb plan-based per agent vc-<skill> <agent> [flags] # skrót; identyczny kontrakt
Agenci: claude · codex · agy · junie · grok · cursor (gemini przyjmowany, zdeprecjonowany na rzecz agy).
Karty niżej nie powtarzają tych flag; wymieniają tylko odchyłki od kontraktu.
-p, --prompt <text>prompt inline
-f, --file <path.md>plik wejściowy jako kontekst zadania (wskaźnik, nie payload w argv)
--prompt-stdinprompt ze stdin; zero kopii w argv/tmp
--runtime <terminal|headless>powierzchnia workera (domyślnie: headless)
--root <path>root repozytorium
--model <name>override modelu agenta
--jsonmaszynowy launch receipt
--count <n>rundy pętli (marbles / polarize; domyślnie 3)
--depth <n>głębokość crawl planu (marbles; domyślnie 3)
--verboseglobalnie: szczegółowy output
Rytm READ/WRITE: etapy czytające budują dowód, etapy piszące tną. decorate (WRITE 2.1.0) wchodzi między dou a hydrate, gdy powierzchnia wymaga wykończenia wizualnego. Parasol całości: vc-ship.
Founder-first planowanie architektury: od mglistego pomysłu do jednego wykonywalnego planu.
vibecrafted scaffold <agent> [flags] vc-scaffold <agent> [flags]
Etap WRITE cyklu: kompletna implementacja e2e z wbudowanym followup i marbles. Nie mylić z justdo.
vibecrafted implement <agent> [flags]
Ograniczony review PR / gałęzi / zakresu commitów / paczki artefaktów — findings przed podsumowaniem.
vibecrafted review <agent> [flags]
Pipeline Examine → Research → Implement dla pracy dotykającej repo.
vibecrafted workflow <agent> [flags]
Audyt kierunku po implementacji: luki, drift, regresje, następna najwyższa dźwignia.
vibecrafted followup <agent> [flags]
Konwergencja prowadzona kontrprzykładami: naprawia to, co wciąż złe, aż powierzchnia trzyma.
vibecrafted marbles <agent> [flags] vibecrafted marbles <pause|stop|resume| session|inspect|delete|gc> [args]
Jeden tab orkiestratora; --count N = rundy L1…LN sekwencyjnie, bez child-tabów.
READ-ONLY falsyfikacja ukończonego planu: macierz wymagań, dowód albo odmowa każdego claimu.
vibecrafted audit <agent> [flags]
Po marbles: zdejmuje nadmiar do jednej obronnej prawdy. Preflight przez loct prism.
vibecrafted polarize <agent> [flags]
Dodatkowo honoruje --count / --depth.
Definition of Undone: audyt całej powierzchni produktu widzianej oczami kupującego.
vibecrafted dou <agent> [flags]
Późne wykończenie wizualne i spójność doświadczenia — w języku projektowym użytkownika.
vibecrafted decorate <agent> [flags]
Pakowanie i go-to-market: od findings DoU do produktu, który da się kupić.
vibecrafted hydrate <agent> [flags]
Finalny ship na zewnątrz: bezpiecznie, widocznie, deploy-owalnie, odwracalnie.
vibecrafted release <agent> [flags]
Postura Just Do: bierz zadanie i dowieź, typ pracy definiuje prompt. Furtka poza pipeline (ADR-0001) — nie jest etapem vc-ship i nie jest implementem.
vibecrafted justdo <agent> [flags]
Audyt prawdy plan-vs-runtime: co z zaplanowanego faktycznie wylądowało w kodzie.
vibecrafted intents <agent> [flags]
Wieloagentowy research przed implementacją; uno|duo|trio deklaruje dokładną liczbę torów.
vibecrafted research [agents...] [flags] vibecrafted research <uno|duo|trio> <agents...> vibecrafted swarm [...] # alias
Dodatkowo --synthesizer <agent>; sidecary vc-research-await, vc-research-synthesize.
Kuracja runtime i stożka publikacji: tnie tylko udowodnione martwe, wystawia zapomniane perły.
vibecrafted prune <agent> [flags]
Post-hoc falsyfikacja claimów commitowych (w tym agent fairness); projekcja werdyktów na oś f/x/n. Nigdy nie blokuje — od blokowania jest guard.
vibecrafted trust <agent> [flags]
Egzekutor w locie: inwentarz bramek + odmowa kontynuacji przy trust block na HEAD. Fail-closed.
vibecrafted guard <agent> [flags]
Postury: wspólne sterowanie z operatorem (partner), pełne przejęcie A→Z (ownership), natywna delegacja in-session (delegate), kontrakt delegacji floty (agents).
vibecrafted partner <agent> [flags] vibecrafted ownership <agent> [flags] vibecrafted delegate <agent> [flags]
vibecrafted <agent> <mode> — identyczny szablon dla claude / codex / agy / junie / grok / cursor (gemini → agy).
| tryb | argument | rola |
|---|---|---|
implement | <plan.md> | wykonaj plik planu |
research | <plan.md> | research tematu lub planu, jeden agent |
review | <plan.md> | review ograniczonego PR / gałęzi / zakresu / paczki |
plan | <plan.md> | wygeneruj plan implementacji |
prompt | <plan.md> | wolny prompt z kontekstem planu |
observe | --last | --run-id | podejrzyj ostatni raport / transkrypt |
await | --last | --run-id | czekaj na terminalne meta + podsumowanie (kanoniczny sygnał wake) |
stop | --run-id | --last | TERM na process group launchera, oznacz stopped |
resume | --run-id | --last | kontynuuj zatrzymany run jako NOWY tracked job |
Interaktywna orientacja agenta w repo: historia, oczy (Loctree), weryfikacja gruntu.
vibecrafted init [claude|codex|agy|junie|grok|cursor|omp] vc-init [agent]
Trzy tryby: wznowienie zatrzymanego runa control-plane, natywne wznowienie sesji providera, albo pakiet ciągłości AICX (48 h) bez id.
vibecrafted resume <agent> --run-id work-… vibecrafted resume <agent> --session <uuid> vibecrafted resume <agent> # AICX pack vc-resume …
Flagi: --last, -p/-f, --fork-session (tylko claude). Nigdy work-* ani VIBECRAFTED_SESSION_ID do --session. Okno AICX: VIBECRAFTED_RESUME_AICX_HOURS.
Dzisiejsza aktywność agentów.
vibecrafted status # alias: stats
Zdrowie instalacji przez bramkę doctora frameworka; potrafi naprawić serwis serwera.
vibecrafted doctor [--fix-server-service] vibecrafted check # alias
Kwit delivery/runtime: owner/repo → branch → SHA checkoutu → dirty → zainstalowane SHA → ahead/behind, per narzędzie floty.
vibecrafted receipt
Pobierz najnowszy release i przeinstaluj lokalny command deck.
vibecrafted update [--force] [--ref <channel>] vibecrafted upgrade # alias
Odwróć instalację: inwentarz → backup (restore kit) → usunięcie manifest-tracked + discovery. Odwrotność: restore.
vibecrafted uninstall [--dry-run] vibecrafted remove # alias
Uwaga: do 82dbce90 deck gubił argv — --dry-run wykonywał prawdziwy teardown. Naprawione + test regresyjny.
Wersja (X.Y.Z+g<sha>) i talia komend / pełna referencja.
vibecrafted version # -v, --version vibecrafted help [topic|--all] vc-help …
Cienki shim nad natywnym vc-frame: sesje operatorskie i layouty.
vibecrafted dashboard [layout] vibecrafted dashboard ls|switch|attach|kill <name> vibecrafted dashboard gc [--apply] vibecrafted start # alias dashboard
Layouty: dashboard (domyślny) · marbles · workflow · research · operator.
Interaktywna kontynuacja Agent-Operatora + łańcuchy async await po workerach.
vibecrafted loop start --prompt|--file … [--completion-promise READY] vibecrafted loop next | status | complete --promise vibecrafted loop await-run --run-id <id> --then-cmd '<next dispatch>'
Stan: <repo>/.vibecrafted/operator-loop.local.md. --then-cmd nigdy push/deploy bez planu.
Cron-safe heartbeat pętli: łapie kontekst Loctree+AICX, wznawia zatwierdzoną komendę po oknie idle.
vibecrafted cron tick [--root] [--after-idle-minutes 10] [--then-cmd <cmd>] vibecrafted cron line [--every-minutes 10] …
tick odmawia hard-stopów: push, deploy, publish, release, reset, rm -rf…
Deterministyczny supervisor planów vibecrafted.dispatch.v1 (TOML) + async lifecycle jednego workera.
vibecrafted dispatch <plan.dispatch.toml> [--doctor|--dry-run|--json|--resume <run-id>] vibecrafted dispatch run --run-id <id> --root <p> --report <p> --transcript <p> -- <cmd> [args]
Lokalny serwer viewera control-plane + jego guardian; serwis trwały przez launchd (macOS).
vibecrafted server [start|stop|status|open|doctor] vibecrafted server service [install|start|stop|status|uninstall]
Flagi: --port/-p (3024) · --host/-h (127.0.0.1).
GUI: localhost-owy pythonowy control plane. TUI: rustowy kokpit voc nad wspólnym stanem.
vibecrafted gui [--source] [--host] [--port] [--no-open] [--bundle-dir] vibecrafted tui [voc flags…] # binarka: voc voc [--state-root] [--deck] [--runtime] [--tick-ms]
Smoke ścieżki telemetrii marbles przez zainstalowany deck.
vibecrafted telemetry smoke [--agent <a>] [--count <n>] [--root <p>] [--no-watch|--watch]
Start pętli VC-Ship i dispatch checkpointu — parasol 11-etapowego lifecycle'u z supervisorem.
vibecrafted ship [args] vc-ship <agent> --prompt "Run the full lifecycle"
Cztery gatunki: env-wrapper na binarkę release, wrapper-alias na komendę decka, natywna binarka Mach-O, samodzielny skrypt. Wszystkie wrappery przekazują "$@".
| launcher | gatunek | cel |
|---|---|---|
vibecrafted | env-wrapper | kanoniczny deck (release bin) |
vc-init · vc-resume · vc-fork · vc-operator · vc-canary · vc-help · vc-dashboard · vc-dispatch · vc-justdo · vc-doctor · vc-status · vc-update · vc-reinstall · vc-receipt · vc-scaffold-doctor · vc-await · vc-capabilities · vc-claims · vc-message · vc-observe · vc-resume-session · vc-settlements · vc-stop · vc-uninstall · vc-workspace | wrapper-alias decka | exec vibecrafted <verb> "$@" — codzienne verby zawsze też w rodzinie vc-* (dwie warstwy, jeden świat; od 9536f198). vc-fork to publiczny bliźniak vibecrafted fork, nie fallback skilla. |
vc-scaffold vc-implement vc-review vc-workflow vc-followup vc-marbles vc-audit vc-polarize vc-dou vc-decorate vc-hydrate vc-release | env-wrapper | binarka release o tej samej nazwie (etapy ship-cycle) |
vc-agents vc-intents vc-partner vc-ownership vc-delegate vc-research vc-prune vc-trust vc-guard vc-ship | env-wrapper | binarka release o tej samej nazwie (skille poza pipeline) |
vc-research-await · vc-research-synthesize | env-wrapper | sidecary research swarm |
vc-loop · vc-cron · vc-start · vc-theme · vc-paste · vc-git · vc-sandbox · vc-guardian · vc-server-supervisor · vibecrafted-compact-hook · vibecrafted-resume · vibecrafted-server-web | env-wrapper | binarki release powierzchni operatora / runtime |
vc-frame | env-wrapper | binarka release vc-frame (mux operatora) |
vc-terminal | env-wrapper | Vibecrafted.app/Contents/Helpers/vc-terminal.app/…/alacritty --config-file vc-terminal.toml |
vc-server · vc-admin · voc | Mach-O arm64 | natywne binarki (serwer control-plane · admin · kokpit TUI) |
vc-slack | skrypt (703 linie) | konektor Slack + mostek floty; własny root przez symlink-walk → providers/vc-slack-agent/current |
vc-tools | skrypt | pnpm run tui w Libraxis/vetcoders-tools (spoza payloadu) |
vibecrafted-mcp · vibecrafted-iterm2-autolaunch | uv-shim | środowiska uv tools (serwer MCP · autolaunch iTerm2) |
verify-vibecrafted-walkaround | env-wrapper | weryfikator walk-around (Verification Rule) |
Dwa przeloty ownership wg playbooka canary-sweep rev 2 (loctree-first, 2026-08-07/08): pełna flota na host-a — 17/17 kanarków, 2842 jednostki, 1999 docstringów, 103 pliki, ~18 min ściany, 0 zmian logiki, ~3.0 M tokenów; oraz lokalny run workflow-canary-sweep-20260809-vibecrafted (schema canary-catalog.v1): 2049 jednostek w 20 chunkach, 25 docstringów, 12 plików, authority repo_verified. Doktryna rev 2: inwentarz TYLKO ze snapshot-query loctree — loct context --full to orientacja, nie spis (klasa coverage-lie: 26/1074 plików bez ostrzeżenia). Poniżej moduły niosące komendy tego katalogu.
| komenda / powierzchnia | moduł | rola (z canary) |
|---|---|---|
| <skill> <agent>, stop/retry | workflow.py | rdzeń runtime całego życia runa: normalizuje launch spec, spawnuje dispatchera (headless albo tab vc-frame), potem stop/retry/block |
| research · marbles · polarize | workflow_runtime.py | nadzorowany runtime rodzica: fan-out procesów-dzieci przez AsyncSupervisor, zbiór trwałych artefaktów |
| rejestr skilli | workflows/registry.py | jedyne źródło prawdy: 21 definicji workflow, 11-etapowy pipeline vc-ship, 12 manifestów per-etap |
| dispatch (plan TOML) | dispatch/supervisor.py | deterministyczny control-plane: idzie po cutach planu, bramkuje każdą na execution envelope |
| dispatch (parser) | dispatch/schema.py | TOML dispatch.v1 → w pełni zwalidowany typowany Dispatch; wszystkie defekty w jednym przebiegu |
| dispatch run | dispatcher.py | jeden worker pod AsyncSupervisor: kontrakt artefaktów, terminalna prawda |
| weryfikatory cutów | dispatch/verify.py | deterministyczny silnik verify: komendy shell cuta → trójwartościowy Verdict z dowodem |
| loop | loop.py | dwie powierzchnie pod jednym CLI: pętla iteracji operatora (plik stanu md) + await-chains |
| cron | cron.py | heartbeat crontabowy pętli: czyta frontmatter stanu, snapshot kontekstu przez loct + aicx |
| server / guardian | server_supervisor.py | jednoplikowa płaszczyzna nadzoru pary serwer+guardian: lease flock, kontrakt tożsamości buildu (content-hash) |
| powiadomienia / triage | guardian.py | daemon-konsument SSE: settlementy serwera → trwałe joby triage, powiadomienia operatora, strzeżone native resume |
| receipt | runtime_receipt.py | kwit delivery/runtime: owner/repo → branch → SHA → dirty → installed SHA → ahead/behind per narzędzie |
| doctor | doctor.py | doctor pakietu: findings instalera + tożsamość launcher/wersja + transport MCP + nadzór LaunchAgent + zdrowie configu vc-frame |
| spawn legacy | spawn.py | lane launcherów shellowych: spawn CLI agentów, scraping session id / tokenów / kosztu z transkryptów |
| parytet modelu | agent_dispatch.py | pythonowy odpowiednik spawn.sh egzekwujący aksjomat parytetu modelu przy delegacji |
| dashboard / vc-frame | vc_frame_delivery.py · vc_frame_tab_gc.py | dostawa configu vc-frame do generacji runtime + proof-gated GC tabów |
| ścieżki | runtime_paths.py | jedyny resolver każdego home'u zapisu; wszystko env-overridable |
Pełny katalog: ~/.vibecrafted/artifacts/vetcoders/vibecrafted/2026_0809/reports/canary-catalog.json (2049 wpisów: plik · symbol · kind · rola · authority) + playbook canary-sweep-playbook.md.
resume-session — reklamowane w vibecrafted help, ale NIE wpięte w dispatch decka (… is not in the command deck). receipt działa (→ runtime_receipt.receipt_main). Stale copy w cmd_help do wycięcia albo komenda do dowiezienia. settlements jest już w dispatch decka i udostępnia zapytania do ledgeru.uninstall gubił całe argv w decku (--dry-run = prawdziwy teardown) — naprawione dziś w 82dbce90 + test regresyjny; inwentarz teardownu rozszerzany o discovery (releases/providers/config/macOS) w osobnym cucie.vc-init init, vc-resume resume…) — nie ma ich w uv-receipt; bug instalera do naprawy.gemini wciąż przyjmowany w dispatchu agentów, choć zdeprecjonowany (następca: agy) — spójność komunikatu do decyzji.vc-server na PATH to już natywna binarka Mach-O; vc-server.wrapper-bak-0819 to trup po wrapperze, który zabijał identity guard — do sprzątnięcia.