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/test/server.test.mjs

View on GitHub
// Vendored from agent-activity-viewer, adapted for this package:
//  - the child's stderr is surfaced so the failure can be classified;
//  - an environment that forbids binding a localhost socket reports a skip
//    instead of a failure (some sandboxes return EPERM for listen()).
// The package's own viewer entry point is covered by tests/replay.test.mjs.
import test from 'node:test';
import assert from 'node:assert/strict';
import { spawn } from 'node:child_process';
import fsp from 'node:fs/promises';
import os from 'node:os';
import path from 'node:path';

async function start(args = []) {
  const child = spawn(process.execPath, ['src/server.mjs', '--port', '0', ...args], {
    cwd: new URL('..', import.meta.url), stdio: ['ignore', 'pipe', 'pipe'],
  });
  let stderr = '';
  child.stderr.on('data', (chunk) => { stderr += chunk; });
  const url = await new Promise((resolve, reject) => {
    let out = '';
    const timer = setTimeout(() => { child.kill(); reject(new Error('Server startup timeout')); }, 5000);
    child.stdout.on('data', (chunk) => {
      out += chunk;
      const match = out.match(/Viewer: (\S+)/);
      if (match) { clearTimeout(timer); resolve(match[1]); }
    });
    child.once('exit', (code) => {
      clearTimeout(timer);
      reject(new Error(`Server exited ${code}: ${stderr.trim()}`));
    });
  });
  return { child, url: new URL(url), stderr: () => stderr };
}

function listeningBlocked(message) {
  return /EPERM|EACCES|operation not permitted|listen/i.test(message);
}

test('server protects data and tails explicit lifecycle events', async (t) => {
  const dir = await fsp.mkdtemp(path.join(os.tmpdir(), 'viewer-api-'));
  const file = path.join(dir, 'events.jsonl');
  const event = (id, type) => ({ schemaVersion: 1, eventId: id, agentId: 'lead', parentAgentId: null, at: new Date().toISOString(), type, data: {} });
  await fsp.writeFile(file, `${JSON.stringify(event('1', 'agent.started'))}\n`);
  let child;
  try {
    let run;
    try {
      run = await start(['--events', file]);
    } catch (error) {
      if (listeningBlocked(error.message)) {
        t.skip('this environment blocks binding a localhost socket');
        return;
      }
      throw error;
    }
    child = run.child;
    const base = run.url.origin;
    assert.equal((await fetch(`${base}/api/state`)).status, 401);
    const headers = { Authorization: `Bearer ${run.url.hash.slice(7)}` };
    assert.equal((await fetch(`${base}/api/state`, { headers: { ...headers, Origin: 'https://example.com' } })).status, 403);
    assert.equal((await fetch(`${base}/api/state`, { method: 'POST', headers })).status, 405);
    let state = await (await fetch(`${base}/api/state`, { headers })).json();
    assert.equal(state.mode, 'Live');
    assert.equal(state.events.length, 1);
    await fsp.appendFile(file, `${JSON.stringify(event('2', 'agent.returned'))}\n`);
    await new Promise((resolve) => setTimeout(resolve, 1200));
    state = await (await fetch(`${base}/api/state`, { headers })).json();
    assert.equal(state.events.at(-1).type, 'agent.returned');
    assert.equal(state.sources[0].status, 'Watching');
  } finally {
    child?.kill();
    await fsp.rm(dir, { recursive: true, force: true });
  }
});
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: 471kUpdated 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