⚒ Katalog launcherów Vibecrafted

Pełna powierzchnia komend decka vibecrafted 4.1.0+g237d2814: rola, subkomendy, flagi i mapowanie każdego launchera — zebrane z żywych helpów, kodu decka i canary sweep repo.

31 komend decka
21 skill-launcherów
52 wpisy w ~/.local/bin
6 agentów × 9 trybów
11 etapów ship-cycle
2049 jednostek canary

Anatomia wywołania

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).

Kontrakt flag — wspólny dla wszystkich skilli

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

Ship-cycle — 11 etapów w kolejności kanonicznej

scaffold → implement → review → workflow → followup → marbles → audit → polarize → dou → hydrate → release

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.

scaffold READ0.2.0

Founder-first planowanie architektury: od mglistego pomysłu do jednego wykonywalnego planu.

vibecrafted scaffold <agent> [flags]
vc-scaffold <agent> [flags]

implement WRITE2.2.0

Etap WRITE cyklu: kompletna implementacja e2e z wbudowanym followup i marbles. Nie mylić z justdo.

vibecrafted implement <agent> [flags]

review READ2.0.0

Ograniczony review PR / gałęzi / zakresu commitów / paczki artefaktów — findings przed podsumowaniem.

vibecrafted review <agent> [flags]

workflow WRITE3.6.0

Pipeline Examine → Research → Implement dla pracy dotykającej repo.

vibecrafted workflow <agent> [flags]

followup READ2.2.0

Audyt kierunku po implementacji: luki, drift, regresje, następna najwyższa dźwignia.

vibecrafted followup <agent> [flags]

marbles WRITE7.0.0

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.

audit READ1.0.0

READ-ONLY falsyfikacja ukończonego planu: macierz wymagań, dowód albo odmowa każdego claimu.

vibecrafted audit <agent> [flags]

polarize WRITE2.0.0

Po marbles: zdejmuje nadmiar do jednej obronnej prawdy. Preflight przez loct prism.

vibecrafted polarize <agent> [flags]

Dodatkowo honoruje --count / --depth.

dou READ2.1.0

Definition of Undone: audyt całej powierzchni produktu widzianej oczami kupującego.

vibecrafted dou <agent> [flags]

decorate WRITE2.1.0

Późne wykończenie wizualne i spójność doświadczenia — w języku projektowym użytkownika.

vibecrafted decorate <agent> [flags]

hydrate WRITE1.0.0

Pakowanie i go-to-market: od findings DoU do produktu, który da się kupić.

vibecrafted hydrate <agent> [flags]

release WRITE0.2.1

Finalny ship na zewnątrz: bezpiecznie, widocznie, deploy-owalnie, odwracalnie.

vibecrafted release <agent> [flags]

Skille poza pipeline

justdo WRITE3.1.0

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]

intents READ1.0.1

Audyt prawdy plan-vs-runtime: co z zaplanowanego faktycznie wylądowało w kodzie.

vibecrafted intents <agent> [flags]

research READ1.3.0

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.

prune READ3.3.3

Kuracja runtime i stożka publikacji: tnie tylko udowodnione martwe, wystawia zapomniane perły.

vibecrafted prune <agent> [flags]

trust READ1.0.0

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]

guard READ1.0.0

Egzekutor w locie: inwentarz bramek + odmowa kontynuacji przy trust block na HEAD. Fail-closed.

vibecrafted guard <agent> [flags]

partner · ownership · delegate · agents

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]

Tryby agentowe — jednolita matryca ×6 agentów

vibecrafted <agent> <mode> — identyczny szablon dla claude / codex / agy / junie / grok / cursor (gemini → agy).

trybargumentrola
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-idpodejrzyj ostatni raport / transkrypt
await--last | --run-idczekaj na terminalne meta + podsumowanie (kanoniczny sygnał wake)
stop--run-id | --lastTERM na process group launchera, oznacz stopped
resume--run-id | --lastkontynuuj zatrzymany run jako NOWY tracked job

Zarządzanie instalacją i sesją

init MGMT

Interaktywna orientacja agenta w repo: historia, oczy (Loctree), weryfikacja gruntu.

vibecrafted init [claude|codex|agy|junie|grok|cursor|omp]
vc-init [agent]

resume MGMT

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.

status MGMT

Dzisiejsza aktywność agentów.

vibecrafted status    # alias: stats

doctor MGMT

Zdrowie instalacji przez bramkę doctora frameworka; potrafi naprawić serwis serwera.

vibecrafted doctor [--fix-server-service]
vibecrafted check     # alias

receipt MGMT

Kwit delivery/runtime: owner/repo → branch → SHA checkoutu → dirty → zainstalowane SHA → ahead/behind, per narzędzie floty.

vibecrafted receipt

update MGMT

Pobierz najnowszy release i przeinstaluj lokalny command deck.

vibecrafted update [--force] [--ref <channel>]
vibecrafted upgrade   # alias

uninstall MGMT

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.

version · help MGMT

Wersja (X.Y.Z+g<sha>) i talia komend / pełna referencja.

vibecrafted version   # -v, --version
vibecrafted help [topic|--all]
vc-help …

Powierzchnia operatora

dashboard OPS

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.

loop OPS

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 OPS

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…

dispatch OPS

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]

server OPS

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 · tui OPS

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]

telemetry OPS

Smoke ścieżki telemetrii marbles przez zainstalowany deck.

vibecrafted telemetry smoke [--agent <a>]
  [--count <n>] [--root <p>] [--no-watch|--watch]

ship OPS

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"

Mapping — co naprawdę woła każdy wpis w ~/.local/bin

Cztery gatunki: env-wrapper na binarkę release, wrapper-alias na komendę decka, natywna binarka Mach-O, samodzielny skrypt. Wszystkie wrappery przekazują "$@".

launchergatunekcel
vibecraftedenv-wrapperkanoniczny 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-workspacewrapper-alias deckaexec 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-releaseenv-wrapperbinarka 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-shipenv-wrapperbinarka release o tej samej nazwie (skille poza pipeline)
vc-research-await · vc-research-synthesizeenv-wrappersidecary 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-webenv-wrapperbinarki release powierzchni operatora / runtime
vc-frameenv-wrapperbinarka release vc-frame (mux operatora)
vc-terminalenv-wrapperVibecrafted.app/Contents/Helpers/vc-terminal.app/…/alacritty --config-file vc-terminal.toml
vc-server · vc-admin · vocMach-O arm64natywne binarki (serwer control-plane · admin · kokpit TUI)
vc-slackskrypt (703 linie)konektor Slack + mostek floty; własny root przez symlink-walk → providers/vc-slack-agent/current
vc-toolsskryptpnpm run tui w Libraxis/vetcoders-tools (spoza payloadu)
vibecrafted-mcp · vibecrafted-iterm2-autolaunchuv-shimśrodowiska uv tools (serwer MCP · autolaunch iTerm2)
verify-vibecrafted-walkaroundenv-wrapperweryfikator walk-around (Verification Rule)

Canary sweep — kto to implementuje (właściciele w kodzie)

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 / powierzchniamodułrola (z canary)
<skill> <agent>, stop/retryworkflow.pyrdzeń runtime całego życia runa: normalizuje launch spec, spawnuje dispatchera (headless albo tab vc-frame), potem stop/retry/block
research · marbles · polarizeworkflow_runtime.pynadzorowany runtime rodzica: fan-out procesów-dzieci przez AsyncSupervisor, zbiór trwałych artefaktów
rejestr skilliworkflows/registry.pyjedyne źródło prawdy: 21 definicji workflow, 11-etapowy pipeline vc-ship, 12 manifestów per-etap
dispatch (plan TOML)dispatch/supervisor.pydeterministyczny control-plane: idzie po cutach planu, bramkuje każdą na execution envelope
dispatch (parser)dispatch/schema.pyTOML dispatch.v1 → w pełni zwalidowany typowany Dispatch; wszystkie defekty w jednym przebiegu
dispatch rundispatcher.pyjeden worker pod AsyncSupervisor: kontrakt artefaktów, terminalna prawda
weryfikatory cutówdispatch/verify.pydeterministyczny silnik verify: komendy shell cuta → trójwartościowy Verdict z dowodem
looploop.pydwie powierzchnie pod jednym CLI: pętla iteracji operatora (plik stanu md) + await-chains
croncron.pyheartbeat crontabowy pętli: czyta frontmatter stanu, snapshot kontekstu przez loct + aicx
server / guardianserver_supervisor.pyjednoplikowa płaszczyzna nadzoru pary serwer+guardian: lease flock, kontrakt tożsamości buildu (content-hash)
powiadomienia / triageguardian.pydaemon-konsument SSE: settlementy serwera → trwałe joby triage, powiadomienia operatora, strzeżone native resume
receiptruntime_receipt.pykwit delivery/runtime: owner/repo → branch → SHA → dirty → installed SHA → ahead/behind per narzędzie
doctordoctor.pydoctor pakietu: findings instalera + tożsamość launcher/wersja + transport MCP + nadzór LaunchAgent + zdrowie configu vc-frame
spawn legacyspawn.pylane launcherów shellowych: spawn CLI agentów, scraping session id / tokenów / kosztu z transkryptów
parytet modeluagent_dispatch.pypythonowy odpowiednik spawn.sh egzekwujący aksjomat parytetu modelu przy delegacji
dashboard / vc-framevc_frame_delivery.py · vc_frame_tab_gc.pydostawa configu vc-frame do generacji runtime + proof-gated GC tabów
ścieżkiruntime_paths.pyjedyny 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.

Rozjazdy help vs kod — do naprawy