ethanplusai/codex-on-crack / plugins/codex-on-crack/skills/crack-setup
crack-setup
UnverifiedConfigure or change the approved worker models for codex-on-crack, inspect available models and compatibility, preview role files, or undo a setup. The user selects the lead in Codex. Setup preserves root settings, credentials, unrelated agents, and config.toml.
Choose workers; preserve the lead
Helpers live in ../crack/scripts/. Keep the user's existing model/provider
choices. Installing skills alone does not configure workers or change the lead.
- Run
node ../crack/scripts/setup.mjs scanwith the session's home/profile. Show relevant eligible models, efforts, image support, context, and exclusions. Catalog presence is not account access or a working provider route. Do not rank capabilities the catalog does not establish or invent prices. - Read an existing
crack.tomlbefore proposing changes. Start with one builder chosen by the user. Additional roles can map toimplementation,ui,review,research, ortestswith atasksarray. These are user preferences, not demonstrated model strengths. Set the exact model and a supported effort; keep fallback optional. Never change the selected lead to make setup pass. - Write a draft in a task-owned directory. Preview with
node ../crack/scripts/setup.mjs plan --roles DRAFTand show the concrete model/effort and file changes. Apply the agreed configuration withnode ../crack/scripts/setup.mjs apply --roles DRAFT. If the specific model choices or global writes aren't yet authorized, obtain that decision after producing the preview. Don't repeat approval already given for those choices. - Return the receipt path and explain that a fresh client session must load the
generated native roles. Run
doctor.mjs; then use a real authorized task to verify child metadata. No paid installation smoke test is needed.
Draft shape (replace the model with an exact eligible ID):
schema_version = 1
[roles.builder]
model = "MODEL_FROM_SCAN"
writes = true
tasks = ["implementation", "tests"]
brief = "Implements the scoped task and verifies it for lead review."
Role names use lowercase letters/digits/underscores and cannot end _fallback.
Read-only roles set writes = false. Use capability/route checks, not a model's
brand, to determine whether a proposed setup is compatible. A model recommendation
does not grant permission to share private source with a new provider.
The current adapter conservatively checks the inherited parent provider. Native-model and Router-model catalog entries may both exist without a compatible mixed-provider session. Stop and explain an incompatible route; do not rewrite endpoints, credentials, or permissions. Custom-role model settings take precedence over a spawn override, so verify the role actually names the selected model.
Default to no global policy during initial setup. If an old orchestrator policy
is active, explain the conflict and use an authorized --migrate-legacy preview
rather than leaving both workflows active. This backs up/removes only its marked
policy block; old role and skill files remain. Do not migrate merely to inspect
or compare the packages.
Use --profile consistently; setup records profile/catalog for future checks.
An offline --model-catalog can supply metadata only when it does not conflict
with the configured catalog. Setup never refreshes a provider or reads credentials.
Undo previews with setup.mjs undo --receipt PATH; --apply restores only when
no later edits would be overwritten. Preserve receipts and hand-edited files.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |