Skip to content

ethanplusai/codex-on-crack / plugins/codex-on-crack/skills/crack

Lead substantial Codex builds with one configured implementation worker and lead acceptance. Use when the user requests codex-on-crack, names a model to delegate work to, asks to run subagents through Claude, or requests a lead/worker split. Keep host-only work direct; honor explicit external model choices. Workers must not invoke this orchestrator.

FileKindSize
SKILL.mdskill md8.0 KB
agents/openai.yamlconfig300 B
references/build-records.mdmarkdown2.7 KB
references/checkpoint.mdmarkdown1.3 KB
references/external-lead.mdmarkdown13.9 KB
references/measurement.mdmarkdown1.8 KB
references/model-selection.mdmarkdown2.2 KB
references/parallel.mdmarkdown1.7 KB
references/policy.mdmarkdown494 B
references/replay.mdmarkdown3.2 KB
references/verification.mdmarkdown2.1 KB
references/worker-contract.mdmarkdown1.3 KB
scripts/doctor.mjsscript608 B
scripts/lead.mjsscript26.0 KB
scripts/lib/catalog.mjsscript5.6 KB
scripts/lib/changes.mjsscript13.3 KB
scripts/lib/config.mjsscript6.5 KB
scripts/lib/external-lead.mjsscript56.7 KB
scripts/lib/io.mjsscript3.8 KB
scripts/lib/lead-protocol.mjsscript25.9 KB
scripts/lib/plan.mjsscript9.2 KB
scripts/lib/readiness.mjsscript6.0 KB
scripts/lib/report.mjsscript10.7 KB
scripts/lib/roles.mjsscript8.9 KB
scripts/lib/routing.mjsscript2.7 KB
scripts/lib/toml.mjsscript785 B
scripts/lib/trial.mjsscript12.4 KB
scripts/report.mjsscript2.7 KB
scripts/select.mjsscript3.9 KB
scripts/setup.mjsscript7.0 KB
scripts/trial.mjsscript1.8 KB
scripts/validate-plan.mjsscript2.6 KB
scripts/worktree.mjsscript7.8 KB
templates/checkpoint.mdmarkdown903 B
templates/plan.jsonconfig680 B
templates/spec.mdmarkdown742 B
templates/task-brief.mdmarkdown2.5 KB
templates/task-report.mdmarkdown1.5 KB
viewer/README.mdmarkdown5.9 KB
viewer/bridge.mjsscript16.6 KB
viewer/fixtures/sample.jsonconfig8.2 KB
viewer/package.jsonmanifest187 B
viewer/public/app.mjsscript8.8 KB
viewer/public/index.htmlother1.8 KB
viewer/public/style.cssother4.4 KB
viewer/serve.mjsscript11.2 KB
viewer/src/adapter.mjsscript9.9 KB
viewer/src/emit.mjsscript992 B
viewer/src/model.mjsscript8.9 KB
viewer/src/server.mjsscript4.1 KB
viewer/src/tail.mjsscript1.9 KB
viewer/test/browser.mjsscript2.6 KB
viewer/test/server.test.mjsscript3.2 KB
viewer/test/usage.test.mjsscript9.0 KB
viewer/test/viewer.test.mjsscript5.1 KB

viewer/src/server.mjs

View on GitHub
import http from 'node:http';
import fs from 'node:fs/promises';
import path from 'node:path';
import {fileURLToPath} from 'node:url';
import {randomBytes} from 'node:crypto';
import {parseArgs} from 'node:util';
import {Tail} from './tail.mjs';
import {selectEvents} from './adapter.mjs';
const here=path.dirname(fileURLToPath(import.meta.url));
const {values}=parseArgs({options:{session:{type:'string',multiple:true},events:{type:'string',multiple:true},root:{type:'string'},since:{type:'string'},port:{type:'string',default:'4318'},details:{type:'boolean',default:false},help:{type:'boolean'}}});
if(values.help){console.log('npm start -- [--session /absolute/root.jsonl --session /absolute/child.jsonl] [--events /absolute/events.jsonl] [--root ID] [--since ISO_DATE] [--details] [--port 4318]\nNo session: sample replay. Explicit files only. --details exposes reported plan text locally; review before screen recording.');process.exit(0)}
if(values.since&&!Number.isFinite(Date.parse(values.since)))throw Error('Invalid --since timestamp');
const port=Number(values.port);if(!Number.isInteger(port)||port<0||port>65535)throw Error('Invalid port');
const tails=[...new Set(values.session||[])].map((file,i)=>new Tail(path.resolve(file),i,values.details));
for(const file of new Set(values.events||[]))tails.push(new Tail(path.resolve(file),tails.length,values.details,true));
const token=randomBytes(24).toString('hex');let busy=false;
async function poll(){if(busy)return;busy=true;try{await Promise.all(tails.map(t=>t.poll()))}finally{busy=false}}
await poll();const interval=setInterval(poll,1000);
const assets=new Map([['/','../public/index.html'],['/app.mjs','../public/app.mjs'],['/style.css','../public/style.css'],['/model.mjs','./model.mjs']]);
const sample=JSON.parse(await fs.readFile(path.join(here,'../fixtures/sample.json'),'utf8'));
const server=http.createServer(async(req,res)=>{
 const host=req.headers.host;const address=server.address();const expected=`127.0.0.1:${address.port}`;
 res.setHeader('Cache-Control','no-store');res.setHeader('X-Content-Type-Options','nosniff');res.setHeader('Referrer-Policy','no-referrer');res.setHeader('Content-Security-Policy',"default-src 'self'; script-src 'self'; style-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'none'; frame-ancestors 'none'");
 if(host!==expected||req.headers.origin&&req.headers.origin!==`http://${expected}`){res.writeHead(403);res.end('Forbidden');return}
 if(req.method!=='GET'){res.writeHead(405);res.end('Read-only');return}
 const url=new URL(req.url,`http://${expected}`);
 if(url.pathname==='/api/state'){
  if(req.headers.authorization!==`Bearer ${token}`){res.writeHead(401);res.end('Token required');return}
  const root=values.root||tails[0]?.adapter.id;
  const events=tails.length?selectEvents(tails.map(t=>t.adapter),root,values.since):sample.events;
  res.setHeader('Content-Type','application/json');res.end(JSON.stringify({schemaVersion:1,mode:tails.length?'Live':'Sample',events,details:values.details,since:values.since||null,sources:tails.map(t=>({label:`Source ${t.index+1}`,sessionId:t.adapter.id,status:t.status,checkedAt:t.checkedAt,errors:t.adapter.errors,partialLine:t.pending.length>0})),coverage:'Only explicitly selected files are observed. Missing workers and undeclared plans are not inferred. Usage reflects recorded counters only. Subscription quota and human quality remain in the trial report.'}));return;
 }
 if(!assets.has(url.pathname)){res.writeHead(404);res.end('Not found');return}
 try{const file=path.resolve(here,assets.get(url.pathname));res.setHeader('Content-Type',file.endsWith('.css')?'text/css':file.endsWith('.mjs')?'text/javascript':'text/html');res.end(await fs.readFile(file))}catch{res.writeHead(500);res.end('Asset unavailable')}
});
server.listen(port,'127.0.0.1',()=>console.log(`Viewer: http://127.0.0.1:${server.address().port}/#token=${token}\n${tails.length?'Watching selected files, read-only.':'Sample replay only. Add --session to watch a real test.'}`));
server.on('error',e=>{clearInterval(interval);console.error(e.message);process.exitCode=1});
for(const signal of ['SIGTERM','SIGINT'])process.on(signal,()=>{clearInterval(interval);server.close(()=>process.exit(0))});
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: 470kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall