my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	{
#2	"skillId": "clawdex",
#3	"name": "clawdex",
#4	"description": "Clawdex — dual-engine coding agent. Claude Code (reasoning + planning) + OpenAI Codex (fast execution) + Browser Use boxes (web research) + Upstash compute boxes (isolated sandboxes).",
#5	"category": "pump-protocol",
#6	"path": "clawdex/SKILL.md",
#7	"url": "https://x402.wtf/api/skills/clawdex",
#8	"tags": [
#9	"clawdex",
#10	"solana"
#11	],
#12	"requiredEnv": [],
#13	"homepage": null,
#14	"attestation": {
#15	"status": "pending",
#16	"isFormallyVerified": false,
#17	"attestationPda": null,
#18	"verificationTimestamp": null
#19	},
#20	"markdown": "---\nname: clawdex\ndescription: Clawdex — dual-engine coding agent. Claude Code (reasoning + planning) + OpenAI Codex (fast execution) + Browser Use boxes (web research) + Upstash compute boxes (isolated sandboxes).\nmetadata: {\"clawdbot\":{\"emoji\":\"🦞\",\"requires\":{\"anyBins\":[\"claude\",\"codex\"],\"anyServices\":[\"browser-harness-js\",\"upstash-box\"]}}}\n---\n\n# Clawdex\n\nClaude Code plans and reviews. OpenAI Codex executes fast. Browser Use handles the web. Upstash Boxes isolate the compute.\n\n## Install\n\n```bash\n# Codex CLI (bux installs this automatically)\nnpm install -g @openai/codex\n\n# Or from a Clawdbot session:\n/plugin install codex@openai-codex\n```\n\nVerify:\n```bash\ncodex --version\nclaude --version\nbrowser-harness-js --version 2>/dev/null \|\| echo \"browser-harness via BUX\"\n```\n\n---\n\n## Architecture\n\n```\nUser prompt\n │\n ▼\nClaude Code (claude-sonnet-4-6) ← you are here: reason, plan, review\n │\n ├── codex exec \"...\" ← fast code gen / repetitive tasks\n │\n ├── browser-harness-js ← web research, UI testing (BUX browser box)\n │\n └── box.exec.command(...) ← run in Upstash compute sandbox\n```\n\nEach Clawdex run lives in an Upstash Box — ephemeral, isolated, with a box-local Solana wallet and the OpenClawd framework pre-seeded at `/work/openclawd-framework`.\n\n---\n\n## Quick Start\n\n### One-shot task (box run)\n```bash\n# Via the box API\nPOST /api/box/run\n{\n \"boxId\": \"your-box-id\",\n \"prompt\": \"Build a TypeScript CLI that fetches SOL price from Birdeye\",\n \"agentHarness\": \"clawdex\",\n \"agentModel\": \"anthropic/claude-sonnet-4-6\"\n}\n```\n\n### Streaming task (SSE)\n```bash\nPOST /api/box/stream\n{\n \"boxId\": \"your-box-id\",\n \"prompt\": \"Audit the pump SDK for rug pull vectors\",\n \"agentHarness\": \"clawdex\"\n}\n```\n\n### Shell (PTY mode, bux box)\n```bash\n# Claude Code as the harness, Codex available as a tool\nbash pty:true workdir:~/project command:\"claude 'Build a DeFi dashboard, use codex for boilerplate'\"\n\n# Or dispatch directly to Codex for speed\nbash pty:true workdir:~/project command:\"codex exec --full-auto 'Generate Jupiter swap wrapper with error handling'\"\n```\n\n---\n\n## Dual-Engine Dispatch Pattern\n\nClaude Code is the orchestrator. Codex is the executor. Use this pattern:\n\n```\n1. Claude: plan + architecture\n2. Claude → codex exec \"implement <component>\"\n3. Claude: review Codex output\n4. Claude → codex exec \"write tests for <component>\"\n5. Claude: final review + integration\n```\n\n### When to use Codex\n- Boilerplate generation (CRUD, REST handlers, test scaffolds)\n- Repetitive patterns (N similar functions, batch refactors)\n- Speed-critical tasks where --full-auto or --yolo is acceptable\n- PR review batches (parallel codex instances per PR)\n\n### When to stay in Claude Code\n- Architecture decisions\n- Security review\n- Cross-file reasoning\n- Anything touching /work/clawd/ or constitution\n\n---\n\n## Browser Use (BUX boxes)\n\nBUX browser boxes give Clawdex a real Chromium session via the Browser Use Cloud API.\n\n```bash\n# browser-harness-js is installed at:\n# /home/bux/.claude/skills/cdp/sdk/browser-harness-js\n\n# Credentials from:\n# ~/.claude/browser.env (BROWSER_USE_API_KEY)\n\n# Use from Claude Code via bash tool\nbash command:\"browser-harness-js navigate --url https://birdeye.so/token/SOL\"\nbash command:\"browser-harness-js screenshot --out /tmp/page.png\"\n```\n\nWhen Claude hits a login wall / CAPTCHA, it hands the user a live view URL and waits — no credential stuffing.\n\n---\n\n## Upstash Box Compute\n\nEach Clawdex agent gets a provisioned box with:\n\n\| Path \| Contents \|\n\|------\|----------\|\n\| `/work/openclawd-framework/` \| OpenClawd SDK (pre-seeded) \|\n\| `/work/clawd/three-laws.md` \| Agent constitution \|\n\| `/work/clawd/SHELL.md` \| Identity + wallet + hash \|\n\| `/work/clawd/wallet/box-wallet.json` \| Box-local Solana keypair \|\n\| `/work/clawd/.env` \| `AGENT_ID`, `BOX_WALLET_ADDRESS`, `CONSTITUTION_HASH` \|\n\n### Provision a Clawdex box\n```typescript\nimport { provisionAgentBox } from \"@/lib/box/box-service\";\n\nconst box = await provisionAgentBox({\n userId: \"user-123\",\n agentId: \"clawdex-01\",\n agentName: \"Clawdex\",\n agentIdentifier: \"clawdex\",\n});\n// box.id → use this as boxId in /api/box/run or /api/box/stream\n```\n\n### Create a Clawdex box via UI\n1. Go to `/box`\n2. Boxes tab → Create Box\n3. Harness: Clawdex \| Runtime: node \| Model: claude-sonnet-4-6\n\n---\n\n## Codex CLI Reference\n\n```bash\n# One-shot (exits when done)\ncodex exec \"Your prompt\"\ncodex exec --full-auto \"Build a snake game\" # auto-approves in workspace\ncodex --yolo \"Refactor auth module\" # no sandbox, fastest\n\n# Codex needs a git repo\nSCRATCH=$(mktemp -d) && git init $SCRATCH && cd $SCRATCH\ncodex exec \"Your prompt\"\n\n# Background (PTY required)\nbash pty:true workdir:~/project background:true \\\n command:\"codex exec --full-auto 'Add error handling to all API calls'\"\n\n# PR review\ngit worktree add /tmp/pr-review origin/pr-branch\nbash pty:true workdir:/tmp/pr-review command:\"codex review --base main\"\n```\n\nDefault model: `gpt-5.3-codex` (set in `~/.codex/config.toml`)\n\n---\n\n## Parallel Codex Army (batch mode)\n\n```bash\n# Parallel issue fixing\ngit worktree add -b fix/issue-1 /tmp/fix-1 main\ngit worktree add -b fix/issue-2 /tmp/fix-2 main\n\nbash pty:true workdir:/tmp/fix-1 background:true \\\n command:\"codex --yolo 'Fix: <issue-1 description>. Commit.'\"\nbash pty:true workdir:/tmp/fix-2 background:true \\\n command:\"codex --yolo 'Fix: <issue-2 description>. Commit.'\"\n\nprocess action:list\nprocess action:log sessionId:XXX\n```\n\n---\n\n## Plugin Registration\n\nClawdex registers Codex as a plugin with `pluginCount: 1`:\n\n```json\n{\n \"identifier\": \"clawdex\",\n \"pluginCount\": 1,\n \"plugins\": [\n {\n \"id\": \"codex\",\n \"source\": \"openai-codex\",\n \"installCommand\": \"npm install -g @openai/codex\",\n \"bin\": \"codex\",\n \"model\": \"gpt-5.3-codex\"\n }\n ]\n}\n```\n\nInstall from Clawdbot: `/plugin install codex@openai-codex`\n\n---\n\n## Constitution Compliance\n\nClawdex inherits the Three Laws. The constitution hash is sealed in every box at provision time.\n\n```bash\n# Verify constitution integrity\nsha256sum /work/clawd/three-laws.md\ncat /work/clawd/.env \| grep CONSTITUTION_HASH\n# These must match — if they don't, beach before continuing.\n```\n\nLaw I overrides all: never harm, never rugpull, never sign silently.\n\n---\n\n## Rules\n\n1. Claude Code orchestrates — don't hand-code patches when Codex is available\n2. Codex executes — use `--full-auto` for building, vanilla for reviewing\n3. PTY always — `bash pty:true` for all coding agent invocations\n4. Git repo required — Codex refuses to run outside a trusted git dir\n5. Constitution check first — verify hash before any irreversible action\n6. Beach before harm — Law I > everything, including task completion\n7. Never run Codex in ~/clawd/ — it reads soul docs and gets weird ideas\n"
#21	}
#22

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public