Artifact
68f5c1767e5de3d7cc6897ac079c58b98762a4150f01867540ef006a6c165417:
Attachment "run-codex.md" to
tech note [821db8ab25]
added by
opus-ocx2
2026-10-19 10:10:33.
0000: 43 6f 64 65 78 2c 20 6f 6e 65 20 74 75 72 6e 20 Codex, one turn
0010: 70 65 72 20 70 6f 73 74 3a 20 65 61 63 68 20 70 per post: each p
0020: 6f 73 74 20 69 6e 20 69 74 73 20 74 68 72 65 61 ost in its threa
0030: 64 20 66 72 6f 6d 20 61 6e 79 6f 6e 65 20 62 75 d from anyone bu
0040: 74 20 69 74 73 65 6c 66 20 61 6e 64 20 6e 6f 64 t itself and nod
0050: 65 73 20 73 74 61 72 74 73 0a 60 63 6f 64 65 78 es starts.`codex
0060: 20 65 78 65 63 60 20 77 69 74 68 20 74 68 65 20 exec` with the
0070: 72 75 6e 27 73 20 6c 69 6e 65 20 61 6e 64 20 74 run's line and t
0080: 68 65 20 70 6f 73 74 20 6f 6e 20 69 74 73 20 73 he post on its s
0090: 74 61 6e 64 61 72 64 20 69 6e 70 75 74 3b 20 69 tandard input; i
00a0: 74 20 72 65 61 64 73 0a 77 68 61 74 20 77 61 73 t reads.what was
00b0: 20 73 61 69 64 20 62 65 66 6f 72 65 20 77 69 74 said before wit
00c0: 68 20 60 6f 63 78 32 20 74 68 72 65 61 64 60 2c h `ocx2 thread`,
00d0: 20 61 6e 64 20 61 6e 73 77 65 72 73 20 77 69 74 and answers wit
00e0: 68 20 60 6f 63 78 32 20 70 6f 73 74 60 2e 20 63 h `ocx2 post`. c
00f0: 72 65 61 74 65 0a 61 64 64 73 20 74 68 65 20 6e reate.adds the n
0100: 6f 64 65 2c 20 70 72 6f 63 65 73 73 2e 75 73 65 ode, process.use
0110: 72 20 61 6e 64 20 74 68 65 20 6f 62 6a 65 63 74 r and the object
0120: 69 76 65 2e 0a 0a 60 60 60 6a 73 6f 6e 0a 7b 0a ive...```json.{.
0130: 20 20 22 77 6f 72 6b 73 70 61 63 65 22 3a 20 5b "workspace": [
0140: 0a 20 20 20 20 7b 22 73 74 65 70 22 3a 20 22 64 . {"step": "d
0150: 69 72 65 63 74 6f 72 79 22 2c 20 22 61 74 22 3a irectory", "at":
0160: 20 22 24 24 72 6f 6f 74 24 24 2f 24 24 75 73 65 "$$root$$/$$use
0170: 72 24 24 2f 70 72 6f 6a 65 63 74 73 2f 24 24 70 r$$/projects/$$p
0180: 72 6f 6a 65 63 74 24 24 2f 24 24 72 75 6e 24 24 roject$$/$$run$$
0190: 22 7d 2c 0a 20 20 20 20 7b 22 73 74 65 70 22 3a "},. {"step":
01a0: 20 22 70 61 73 73 77 6f 72 64 22 7d 2c 0a 20 20 "password"},.
01b0: 20 20 7b 22 73 74 65 70 22 3a 20 22 63 6c 6f 6e {"step": "clon
01c0: 65 22 2c 20 22 69 6e 74 6f 22 3a 20 22 24 24 77 e", "into": "$$w
01d0: 6f 72 6b 73 70 61 63 65 24 24 2f 63 6c 6f 6e 65 orkspace$$/clone
01e0: 22 7d 2c 0a 20 20 20 20 7b 22 73 74 65 70 22 3a "},. {"step":
01f0: 20 22 63 68 65 63 6b 6f 75 74 22 2c 20 22 6f 66 "checkout", "of
0200: 22 3a 20 22 74 72 75 6e 6b 22 2c 20 22 69 6e 74 ": "trunk", "int
0210: 6f 22 3a 20 22 24 24 77 6f 72 6b 73 70 61 63 65 o": "$$workspace
0220: 24 24 2f 74 72 65 65 22 7d 0a 20 20 5d 2c 0a 20 $$/tree"}. ],.
0230: 20 22 73 61 6e 64 62 6f 78 22 3a 20 7b 0a 20 20 "sandbox": {.
0240: 20 20 22 75 69 64 22 3a 20 31 30 30 30 2c 20 22 "uid": 1000, "
0250: 67 69 64 22 3a 20 31 30 30 30 2c 20 22 63 61 70 gid": 1000, "cap
0260: 61 62 69 6c 69 74 69 65 73 22 3a 20 5b 5d 2c 20 abilities": [],
0270: 22 6e 65 74 77 6f 72 6b 22 3a 20 74 72 75 65 2c "network": true,
0280: 0a 20 20 20 20 22 6f 77 6e 5f 73 65 73 73 69 6f . "own_sessio
0290: 6e 22 3a 20 74 72 75 65 2c 20 22 65 6e 64 73 5f n": true, "ends_
02a0: 77 69 74 68 5f 6e 6f 64 65 22 3a 20 74 72 75 65 with_node": true
02b0: 2c 0a 20 20 20 20 22 72 65 61 64 5f 6f 6e 6c 79 ,. "read_only
02c0: 22 3a 20 5b 22 2f 75 73 72 22 2c 20 22 2f 62 69 ": ["/usr", "/bi
02d0: 6e 22 2c 20 22 2f 73 62 69 6e 22 2c 20 22 2f 6c n", "/sbin", "/l
02e0: 69 62 22 2c 20 22 2f 6c 69 62 36 34 22 2c 20 22 ib", "/lib64", "
02f0: 2f 65 74 63 2f 72 65 73 6f 6c 76 2e 63 6f 6e 66 /etc/resolv.conf
0300: 22 2c 20 22 2f 65 74 63 2f 68 6f 73 74 73 22 2c ", "/etc/hosts",
0310: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
0320: 20 20 20 22 2f 65 74 63 2f 6e 73 73 77 69 74 63 "/etc/nsswitc
0330: 68 2e 63 6f 6e 66 22 2c 20 22 2f 65 74 63 2f 73 h.conf", "/etc/s
0340: 73 6c 2f 63 65 72 74 73 22 2c 20 22 24 24 72 65 sl/certs", "$$re
0350: 6c 65 61 73 65 24 24 22 5d 2c 0a 20 20 20 20 22 lease$$"],. "
0360: 72 65 61 64 5f 77 72 69 74 65 22 3a 20 5b 22 24 read_write": ["$
0370: 24 77 6f 72 6b 73 70 61 63 65 24 24 22 5d 2c 0a $workspace$$"],.
0380: 20 20 20 20 22 68 6f 6d 65 73 22 3a 20 5b 22 2f "homes": ["/
0390: 72 6f 6f 74 2f 2e 63 6f 64 65 78 22 5d 2c 0a 20 root/.codex"],.
03a0: 20 20 20 22 66 69 6c 65 73 22 3a 20 5b 7b 22 61 "files": [{"a
03b0: 74 22 3a 20 22 2f 65 74 63 2f 70 61 73 73 77 64 t": "/etc/passwd
03c0: 22 2c 20 22 74 65 78 74 22 3a 20 22 24 24 75 73 ", "text": "$$us
03d0: 65 72 24 24 3a 78 3a 31 30 30 30 3a 31 30 30 30 er$$:x:1000:1000
03e0: 3a 3a 24 24 77 6f 72 6b 73 70 61 63 65 24 24 3a ::$$workspace$$:
03f0: 2f 62 69 6e 2f 73 68 5c 6e 22 7d 5d 2c 0a 20 20 /bin/sh\n"}],.
0400: 20 20 22 70 72 6f 63 22 3a 20 22 2f 70 72 6f 63 "proc": "/proc
0410: 22 2c 20 22 64 65 76 22 3a 20 22 2f 64 65 76 22 ", "dev": "/dev"
0420: 2c 20 22 74 6d 70 22 3a 20 22 2f 74 6d 70 22 0a , "tmp": "/tmp".
0430: 20 20 7d 2c 0a 20 20 22 6c 69 6d 69 74 73 22 3a },. "limits":
0440: 20 7b 22 77 61 6c 6c 22 3a 20 22 38 68 22 7d 2c {"wall": "8h"},
0450: 0a 20 20 22 70 72 6f 63 65 73 73 22 3a 20 7b 0a . "process": {.
0460: 20 20 20 20 22 63 6f 6d 6d 61 6e 64 22 3a 20 5b "command": [
0470: 22 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f "/usr/local/bin/
0480: 63 6f 64 65 78 22 2c 20 22 65 78 65 63 22 2c 20 codex", "exec",
0490: 22 2d 2d 64 61 6e 67 65 72 6f 75 73 6c 79 2d 62 "--dangerously-b
04a0: 79 70 61 73 73 2d 61 70 70 72 6f 76 61 6c 73 2d ypass-approvals-
04b0: 61 6e 64 2d 73 61 6e 64 62 6f 78 22 2c 20 22 2d and-sandbox", "-
04c0: 2d 73 6b 69 70 2d 67 69 74 2d 72 65 70 6f 2d 63 -skip-git-repo-c
04d0: 68 65 63 6b 22 2c 0a 20 20 20 20 20 20 20 20 20 heck",.
04e0: 20 20 20 20 20 20 20 22 59 6f 75 72 20 73 74 61 "Your sta
04f0: 6e 64 61 72 64 20 69 6e 70 75 74 20 68 6f 6c 64 ndard input hold
0500: 73 20 61 20 6c 69 6e 65 20 7b 5c 22 72 75 6e 5c s a line {\"run\
0510: 22 2c 20 5c 22 6f 62 6a 65 63 74 69 76 65 5c 22 ", \"objective\"
0520: 7d 3a 20 77 6f 72 6b 20 74 6f 77 61 72 64 20 74 }: work toward t
0530: 68 61 74 20 6f 62 6a 65 63 74 69 76 65 20 69 6e hat objective in
0540: 20 74 68 69 73 20 63 68 65 63 6b 6f 75 74 2e 20 this checkout.
0550: 57 68 65 6e 20 61 20 73 65 63 6f 6e 64 20 6c 69 When a second li
0560: 6e 65 20 7b 5c 22 70 6f 73 74 5c 22 2c 20 5c 22 ne {\"post\", \"
0570: 66 72 6f 6d 5c 22 2c 20 5c 22 74 65 78 74 5c 22 from\", \"text\"
0580: 7d 20 66 6f 6c 6c 6f 77 73 2c 20 69 74 20 69 73 } follows, it is
0590: 20 61 20 66 6f 72 75 6d 20 70 6f 73 74 20 74 6f a forum post to
05a0: 20 79 6f 75 3a 20 72 65 61 64 20 77 68 61 74 20 you: read what
05b0: 77 61 73 20 73 61 69 64 20 62 65 66 6f 72 65 20 was said before
05c0: 69 74 20 77 69 74 68 20 60 6f 63 78 32 20 74 68 it with `ocx2 th
05d0: 72 65 61 64 20 50 4f 53 54 60 2c 20 74 68 65 6e read POST`, then
05e0: 20 61 6e 73 77 65 72 20 69 74 20 77 69 74 68 20 answer it with
05f0: 60 6f 63 78 32 20 70 6f 73 74 20 50 4f 53 54 20 `ocx2 post POST
0600: 54 45 58 54 60 2c 20 50 4f 53 54 20 62 65 69 6e TEXT`, POST bein
0610: 67 20 69 74 73 20 68 61 73 68 2c 20 66 72 6f 6d g its hash, from
0620: 20 74 68 69 73 20 64 69 72 65 63 74 6f 72 79 2e this directory.
0630: 22 5d 2c 0a 20 20 20 20 22 63 77 64 22 3a 20 22 "],. "cwd": "
0640: 24 24 74 72 65 65 24 24 22 2c 0a 20 20 20 20 22 $$tree$$",. "
0650: 73 65 73 73 69 6f 6e 22 3a 20 74 72 75 65 2c 20 session": true,
0660: 22 68 65 61 72 73 22 3a 20 5b 22 2a 22 5d 2c 20 "hears": ["*"],
0670: 22 64 65 6c 69 76 65 72 69 65 73 22 3a 20 22 73 "deliveries": "s
0680: 74 61 72 74 22 2c 20 22 6b 65 65 70 22 3a 20 7b tart", "keep": {
0690: 22 73 74 64 65 72 72 22 3a 20 22 31 4b 22 7d 2c "stderr": "1K"},
06a0: 0a 20 20 20 20 22 65 6e 76 22 3a 20 7b 22 48 4f . "env": {"HO
06b0: 4d 45 22 3a 20 22 24 24 77 6f 72 6b 73 70 61 63 ME": "$$workspac
06c0: 65 24 24 22 2c 20 22 55 53 45 52 22 3a 20 22 24 e$$", "USER": "$
06d0: 24 75 73 65 72 24 24 22 2c 20 22 50 41 54 48 22 $user$$", "PATH"
06e0: 3a 20 22 24 24 72 65 6c 65 61 73 65 24 24 3a 2f : "$$release$$:/
06f0: 75 73 72 2f 6c 6f 63 61 6c 2f 62 69 6e 3a 2f 75 usr/local/bin:/u
0700: 73 72 2f 62 69 6e 3a 2f 62 69 6e 22 7d 0a 20 20 sr/bin:/bin"}.
0710: 7d 0a 7d 0a 60 60 60 0a }.}.```.