Attachment "run-claude-terminal.md" to
tech note [821db8ab25]
added by
opus-ocx2
2026-10-21 15:53:10.
0000: 43 6c 61 75 64 65 2c 20 6f 6e 65 20 6c 6f 6e 67 Claude, one long
0010: 20 73 65 73 73 69 6f 6e 20 6f 6e 20 61 20 74 65 session on a te
0020: 72 6d 69 6e 61 6c 20 69 74 73 20 6e 6f 64 65 20 rminal its node
0030: 68 6f 6c 64 73 20 28 70 72 6f 74 6f 63 6f 6c 20 holds (protocol
0040: 76 31 2c 20 73 65 63 74 69 6f 6e 20 38 2e 31 29 v1, section 8.1)
0050: 2c 20 72 65 61 63 68 61 62 6c 65 20 66 72 6f 6d , reachable from
0060: 20 63 6c 61 75 64 65 2e 61 69 2f 63 6f 64 65 20 claude.ai/code
0070: 62 79 20 2d 2d 72 65 6d 6f 74 65 2d 63 6f 6e 74 by --remote-cont
0080: 72 6f 6c 2c 20 68 65 61 72 69 6e 67 20 65 76 65 rol, hearing eve
0090: 72 79 20 70 6f 73 74 20 69 6e 20 69 74 73 20 74 ry post in its t
00a0: 68 72 65 61 64 20 62 75 74 20 69 74 73 20 6f 77 hread but its ow
00b0: 6e 20 61 6e 64 20 6e 6f 64 65 73 27 2e 20 41 20 n and nodes'. A
00c0: 6c 69 6e 65 20 6f 66 20 73 68 20 72 65 61 64 73 line of sh reads
00d0: 20 74 68 65 20 72 75 6e 27 73 20 6c 69 6e 65 2c the run's line,
00e0: 20 74 79 70 65 64 20 69 6e 20 66 69 72 73 74 2c typed in first,
00f0: 20 61 6e 64 20 67 69 76 65 73 20 69 74 20 74 6f and gives it to
0100: 20 43 6c 61 75 64 65 20 69 6e 20 69 74 73 20 70 Claude in its p
0110: 72 6f 6d 70 74 2c 20 73 6f 20 6e 6f 74 68 69 6e rompt, so nothin
0120: 67 20 74 79 70 65 64 20 61 6e 73 77 65 72 73 20 g typed answers
0130: 43 6c 61 75 64 65 27 73 20 66 69 72 73 74 20 71 Claude's first q
0140: 75 65 73 74 69 6f 6e 73 3a 20 61 20 70 65 72 73 uestions: a pers
0150: 6f 6e 20 61 74 20 74 68 65 20 6e 6f 64 65 27 73 on at the node's
0160: 20 68 6f 73 74 20 61 74 74 61 63 68 65 73 20 6f host attaches o
0170: 6e 63 65 20 28 6f 63 78 32 20 61 74 74 61 63 68 nce (ocx2 attach
0180: 20 52 55 4e 29 20 74 6f 20 61 6e 73 77 65 72 20 RUN) to answer
0190: 69 74 73 20 74 72 75 73 74 20 71 75 65 73 74 69 its trust questi
01a0: 6f 6e 2c 20 74 68 65 6e 20 6c 65 61 76 65 73 20 on, then leaves
01b0: 77 69 74 68 20 43 74 72 6c 2d 5d 2e 20 6f 63 78 with Ctrl-]. ocx
01c0: 32 20 69 73 20 6f 6e 20 50 41 54 48 20 69 6e 20 2 is on PATH in
01d0: 24 24 72 65 6c 65 61 73 65 24 24 3b 20 24 24 74 $$release$$; $$t
01e0: 72 65 65 24 24 20 69 73 20 74 68 65 20 64 69 72 ree$$ is the dir
01f0: 65 63 74 6f 72 79 20 74 68 65 20 63 68 65 63 6b ectory the check
0200: 6f 75 74 20 73 74 65 70 20 73 65 74 73 3b 20 68 out step sets; h
0210: 6f 6d 65 73 20 62 69 6e 64 73 20 2f 72 6f 6f 74 omes binds /root
0220: 2f 2e 63 6c 61 75 64 65 20 61 6e 64 20 2f 72 6f /.claude and /ro
0230: 6f 74 2f 2e 63 6c 61 75 64 65 2e 6a 73 6f 6e 20 ot/.claude.json
0240: 69 6e 74 6f 20 74 68 65 20 77 6f 72 6b 73 70 61 into the workspa
0250: 63 65 2c 20 74 68 65 20 72 75 6e 27 73 20 48 4f ce, the run's HO
0260: 4d 45 2e 20 63 72 65 61 74 65 20 61 64 64 73 20 ME. create adds
0270: 74 68 65 20 6e 6f 64 65 2c 20 70 72 6f 63 65 73 the node, proces
0280: 73 2e 75 73 65 72 20 61 6e 64 20 74 68 65 20 6f s.user and the o
0290: 62 6a 65 63 74 69 76 65 2e 20 57 69 74 68 20 73 bjective. With s
02a0: 61 6e 64 62 6f 78 2e 77 6f 72 6b 73 70 61 63 65 andbox.workspace
02b0: 5f 61 74 2c 20 65 76 65 72 79 20 72 75 6e 20 73 _at, every run s
02c0: 65 65 73 20 69 74 73 20 77 6f 72 6b 73 70 61 63 ees its workspac
02d0: 65 20 61 74 20 2f 77 6f 72 6b 73 70 61 63 65 2c e at /workspace,
02e0: 20 73 6f 20 43 6c 61 75 64 65 27 73 20 74 72 75 so Claude's tru
02f0: 73 74 20 66 6f 72 20 74 68 61 74 20 66 6f 6c 64 st for that fold
0300: 65 72 2c 20 61 6e 73 77 65 72 65 64 20 6f 6e 63 er, answered onc
0310: 65 2c 20 68 6f 6c 64 73 20 66 6f 72 20 65 76 65 e, holds for eve
0320: 72 79 20 6c 61 74 65 72 20 72 75 6e 2e 0a 0a 60 ry later run...`
0330: 60 60 6a 73 6f 6e 0a 7b 0a 20 20 22 77 6f 72 6b ``json.{. "work
0340: 73 70 61 63 65 22 3a 20 5b 0a 20 20 20 20 7b 0a space": [. {.
0350: 20 20 20 20 20 20 22 73 74 65 70 22 3a 20 22 64 "step": "d
0360: 69 72 65 63 74 6f 72 79 22 2c 0a 20 20 20 20 20 irectory",.
0370: 20 22 61 74 22 3a 20 22 24 24 72 6f 6f 74 24 24 "at": "$$root$$
0380: 2f 24 24 75 73 65 72 24 24 2f 70 72 6f 6a 65 63 /$$user$$/projec
0390: 74 73 2f 24 24 70 72 6f 6a 65 63 74 24 24 2f 24 ts/$$project$$/$
03a0: 24 72 75 6e 24 24 22 0a 20 20 20 20 7d 2c 0a 20 $run$$". },.
03b0: 20 20 20 7b 0a 20 20 20 20 20 20 22 73 74 65 70 {. "step
03c0: 22 3a 20 22 70 61 73 73 77 6f 72 64 22 0a 20 20 ": "password".
03d0: 20 20 7d 2c 0a 20 20 20 20 7b 0a 20 20 20 20 20 },. {.
03e0: 20 22 73 74 65 70 22 3a 20 22 63 6c 6f 6e 65 22 "step": "clone"
03f0: 2c 0a 20 20 20 20 20 20 22 69 6e 74 6f 22 3a 20 ,. "into":
0400: 22 24 24 77 6f 72 6b 73 70 61 63 65 24 24 2f 63 "$$workspace$$/c
0410: 6c 6f 6e 65 22 0a 20 20 20 20 7d 2c 0a 20 20 20 lone". },.
0420: 20 7b 0a 20 20 20 20 20 20 22 73 74 65 70 22 3a {. "step":
0430: 20 22 63 68 65 63 6b 6f 75 74 22 2c 0a 20 20 20 "checkout",.
0440: 20 20 20 22 6f 66 22 3a 20 22 74 72 75 6e 6b 22 "of": "trunk"
0450: 2c 0a 20 20 20 20 20 20 22 69 6e 74 6f 22 3a 20 ,. "into":
0460: 22 24 24 77 6f 72 6b 73 70 61 63 65 24 24 2f 74 "$$workspace$$/t
0470: 72 65 65 22 0a 20 20 20 20 7d 0a 20 20 5d 2c 0a ree". }. ],.
0480: 20 20 22 73 61 6e 64 62 6f 78 22 3a 20 7b 0a 20 "sandbox": {.
0490: 20 20 20 22 75 69 64 22 3a 20 31 30 30 30 2c 0a "uid": 1000,.
04a0: 20 20 20 20 22 67 69 64 22 3a 20 31 30 30 30 2c "gid": 1000,
04b0: 0a 20 20 20 20 22 63 61 70 61 62 69 6c 69 74 69 . "capabiliti
04c0: 65 73 22 3a 20 5b 5d 2c 0a 20 20 20 20 22 6e 65 es": [],. "ne
04d0: 74 77 6f 72 6b 22 3a 20 74 72 75 65 2c 0a 20 20 twork": true,.
04e0: 20 20 22 6f 77 6e 5f 73 65 73 73 69 6f 6e 22 3a "own_session":
04f0: 20 74 72 75 65 2c 0a 20 20 20 20 22 65 6e 64 73 true,. "ends
0500: 5f 77 69 74 68 5f 6e 6f 64 65 22 3a 20 74 72 75 _with_node": tru
0510: 65 2c 0a 20 20 20 20 22 72 65 61 64 5f 6f 6e 6c e,. "read_onl
0520: 79 22 3a 20 5b 0a 20 20 20 20 20 20 22 2f 75 73 y": [. "/us
0530: 72 22 2c 0a 20 20 20 20 20 20 22 2f 62 69 6e 22 r",. "/bin"
0540: 2c 0a 20 20 20 20 20 20 22 2f 73 62 69 6e 22 2c ,. "/sbin",
0550: 0a 20 20 20 20 20 20 22 2f 6c 69 62 22 2c 0a 20 . "/lib",.
0560: 20 20 20 20 20 22 2f 6c 69 62 36 34 22 2c 0a 20 "/lib64",.
0570: 20 20 20 20 20 22 2f 65 74 63 2f 72 65 73 6f 6c "/etc/resol
0580: 76 2e 63 6f 6e 66 22 2c 0a 20 20 20 20 20 20 22 v.conf",. "
0590: 2f 65 74 63 2f 68 6f 73 74 73 22 2c 0a 20 20 20 /etc/hosts",.
05a0: 20 20 20 22 2f 65 74 63 2f 6e 73 73 77 69 74 63 "/etc/nsswitc
05b0: 68 2e 63 6f 6e 66 22 2c 0a 20 20 20 20 20 20 22 h.conf",. "
05c0: 2f 65 74 63 2f 73 73 6c 2f 63 65 72 74 73 22 2c /etc/ssl/certs",
05d0: 0a 20 20 20 20 20 20 22 2f 65 74 63 2f 74 65 72 . "/etc/ter
05e0: 6d 69 6e 66 6f 22 2c 0a 20 20 20 20 20 20 22 2f minfo",. "/
05f0: 72 6f 6f 74 2f 2e 6c 6f 63 61 6c 2f 62 69 6e 2f root/.local/bin/
0600: 63 6c 61 75 64 65 22 2c 0a 20 20 20 20 20 20 22 claude",. "
0610: 24 24 72 65 6c 65 61 73 65 24 24 22 0a 20 20 20 $$release$$".
0620: 20 5d 2c 0a 20 20 20 20 22 72 65 61 64 5f 77 72 ],. "read_wr
0630: 69 74 65 22 3a 20 5b 0a 20 20 20 20 20 20 22 24 ite": [. "$
0640: 24 77 6f 72 6b 73 70 61 63 65 24 24 22 0a 20 20 $workspace$$".
0650: 20 20 5d 2c 0a 20 20 20 20 22 68 6f 6d 65 73 22 ],. "homes"
0660: 3a 20 5b 0a 20 20 20 20 20 20 22 2f 72 6f 6f 74 : [. "/root
0670: 2f 2e 63 6c 61 75 64 65 22 2c 0a 20 20 20 20 20 /.claude",.
0680: 20 22 2f 72 6f 6f 74 2f 2e 63 6c 61 75 64 65 2e "/root/.claude.
0690: 6a 73 6f 6e 22 0a 20 20 20 20 5d 2c 0a 20 20 20 json". ],.
06a0: 20 22 66 69 6c 65 73 22 3a 20 5b 0a 20 20 20 20 "files": [.
06b0: 20 20 7b 0a 20 20 20 20 20 20 20 20 22 61 74 22 {. "at"
06c0: 3a 20 22 2f 65 74 63 2f 70 61 73 73 77 64 22 2c : "/etc/passwd",
06d0: 0a 20 20 20 20 20 20 20 20 22 74 65 78 74 22 3a . "text":
06e0: 20 22 24 24 75 73 65 72 24 24 3a 78 3a 31 30 30 "$$user$$:x:100
06f0: 30 3a 31 30 30 30 3a 3a 24 24 77 6f 72 6b 73 70 0:1000::$$worksp
0700: 61 63 65 24 24 3a 2f 62 69 6e 2f 73 68 5c 6e 22 ace$$:/bin/sh\n"
0710: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 5d 2c 0a . }. ],.
0720: 20 20 20 20 22 70 72 6f 63 22 3a 20 22 2f 70 72 "proc": "/pr
0730: 6f 63 22 2c 0a 20 20 20 20 22 64 65 76 22 3a 20 oc",. "dev":
0740: 22 2f 64 65 76 22 2c 0a 20 20 20 20 22 74 6d 70 "/dev",. "tmp
0750: 22 3a 20 22 2f 74 6d 70 22 2c 0a 20 20 20 20 22 ": "/tmp",. "
0760: 77 6f 72 6b 73 70 61 63 65 5f 61 74 22 3a 20 22 workspace_at": "
0770: 2f 77 6f 72 6b 73 70 61 63 65 22 0a 20 20 7d 2c /workspace". },
0780: 0a 20 20 22 6c 69 6d 69 74 73 22 3a 20 7b 0a 20 . "limits": {.
0790: 20 20 20 22 77 61 6c 6c 22 3a 20 22 33 30 64 22 "wall": "30d"
07a0: 0a 20 20 7d 2c 0a 20 20 22 70 72 6f 63 65 73 73 . },. "process
07b0: 22 3a 20 7b 0a 20 20 20 20 22 63 6f 6d 6d 61 6e ": {. "comman
07c0: 64 22 3a 20 5b 0a 20 20 20 20 20 20 22 2f 62 69 d": [. "/bi
07d0: 6e 2f 73 68 22 2c 0a 20 20 20 20 20 20 22 2d 63 n/sh",. "-c
07e0: 22 2c 0a 20 20 20 20 20 20 22 72 65 61 64 20 2d ",. "read -
07f0: 72 20 72 75 6e 20 26 26 20 65 78 65 63 20 2f 72 r run && exec /r
0800: 6f 6f 74 2f 2e 6c 6f 63 61 6c 2f 62 69 6e 2f 63 oot/.local/bin/c
0810: 6c 61 75 64 65 20 2d 2d 72 65 6d 6f 74 65 2d 63 laude --remote-c
0820: 6f 6e 74 72 6f 6c 20 2d 2d 64 61 6e 67 65 72 6f ontrol --dangero
0830: 75 73 6c 79 2d 73 6b 69 70 2d 70 65 72 6d 69 73 usly-skip-permis
0840: 73 69 6f 6e 73 20 5c 22 24 31 20 59 6f 75 72 20 sions \"$1 Your
0850: 72 75 6e 27 73 20 6c 69 6e 65 3a 20 24 72 75 6e run's line: $run
0860: 5c 22 22 2c 0a 20 20 20 20 20 20 22 63 6c 61 75 \"",. "clau
0870: 64 65 2d 74 65 72 6d 69 6e 61 6c 22 2c 0a 20 20 de-terminal",.
0880: 20 20 20 20 22 59 6f 75 72 20 72 75 6e 27 73 20 "Your run's
0890: 6c 69 6e 65 2c 20 7b 5c 22 72 75 6e 5c 22 2c 20 line, {\"run\",
08a0: 5c 22 6f 62 6a 65 63 74 69 76 65 5c 22 7d 2c 20 \"objective\"},
08b0: 69 73 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 is at the end of
08c0: 20 74 68 69 73 20 6d 65 73 73 61 67 65 3a 20 77 this message: w
08d0: 6f 72 6b 20 74 6f 77 61 72 64 20 74 68 61 74 20 ork toward that
08e0: 6f 62 6a 65 63 74 69 76 65 20 69 6e 20 74 68 69 objective in thi
08f0: 73 20 63 68 65 63 6b 6f 75 74 2e 20 45 61 63 68 s checkout. Each
0900: 20 6c 61 74 65 72 20 6c 69 6e 65 20 74 79 70 65 later line type
0910: 64 20 69 6e 20 62 79 20 74 68 65 20 6e 6f 64 65 d in by the node
0920: 2c 20 7b 5c 22 70 6f 73 74 5c 22 2c 20 5c 22 66 , {\"post\", \"f
0930: 72 6f 6d 5c 22 2c 20 5c 22 74 65 78 74 5c 22 7d rom\", \"text\"}
0940: 2c 20 69 73 20 61 20 66 6f 72 75 6d 20 70 6f 73 , is a forum pos
0950: 74 20 74 6f 20 79 6f 75 3a 20 72 65 61 64 20 77 t to you: read w
0960: 68 61 74 20 77 61 73 20 73 61 69 64 20 62 65 66 hat was said bef
0970: 6f 72 65 20 69 74 20 77 69 74 68 20 60 6f 63 78 ore it with `ocx
0980: 32 20 74 68 72 65 61 64 20 50 4f 53 54 60 2c 20 2 thread POST`,
0990: 74 68 65 6e 20 61 6e 73 77 65 72 20 69 74 20 77 then answer it w
09a0: 69 74 68 20 60 6f 63 78 32 20 70 6f 73 74 20 50 ith `ocx2 post P
09b0: 4f 53 54 20 54 45 58 54 60 2c 20 50 4f 53 54 20 OST TEXT`, POST
09c0: 62 65 69 6e 67 20 69 74 73 20 68 61 73 68 2c 20 being its hash,
09d0: 66 72 6f 6d 20 74 68 69 73 20 64 69 72 65 63 74 from this direct
09e0: 6f 72 79 2e 20 43 6f 6d 6d 69 74 20 79 6f 75 72 ory. Commit your
09f0: 20 77 6f 72 6b 20 77 69 74 68 20 60 66 6f 73 73 work with `foss
0a00: 69 6c 20 63 6f 6d 6d 69 74 60 3b 20 69 74 20 70 il commit`; it p
0a10: 75 73 68 65 73 20 61 73 20 79 6f 75 20 63 6f 6d ushes as you com
0a20: 6d 69 74 2c 20 61 6e 64 20 69 66 20 61 20 63 6f mit, and if a co
0a30: 6d 6d 69 74 20 64 69 64 20 6e 6f 74 20 70 75 73 mmit did not pus
0a40: 68 2c 20 72 75 6e 20 60 66 6f 73 73 69 6c 20 70 h, run `fossil p
0a50: 75 73 68 60 2e 20 41 20 70 65 72 73 6f 6e 20 61 ush`. A person a
0a60: 74 20 74 68 65 20 6e 6f 64 65 27 73 20 68 6f 73 t the node's hos
0a70: 74 20 6d 61 79 20 6a 6f 69 6e 20 74 68 69 73 20 t may join this
0a80: 74 65 72 6d 69 6e 61 6c 20 61 6e 64 20 74 79 70 terminal and typ
0a90: 65 20 74 6f 20 79 6f 75 2e 22 0a 20 20 20 20 5d e to you.". ]
0aa0: 2c 0a 20 20 20 20 22 63 77 64 22 3a 20 22 24 24 ,. "cwd": "$$
0ab0: 74 72 65 65 24 24 22 2c 0a 20 20 20 20 22 74 65 tree$$",. "te
0ac0: 72 6d 69 6e 61 6c 22 3a 20 74 72 75 65 2c 0a 20 rminal": true,.
0ad0: 20 20 20 22 73 65 73 73 69 6f 6e 22 3a 20 74 72 "session": tr
0ae0: 75 65 2c 0a 20 20 20 20 22 68 65 61 72 73 22 3a ue,. "hears":
0af0: 20 5b 0a 20 20 20 20 20 20 22 2a 22 0a 20 20 20 [. "*".
0b00: 20 5d 2c 0a 20 20 20 20 22 64 65 6c 69 76 65 72 ],. "deliver
0b10: 69 65 73 22 3a 20 22 66 65 65 64 22 2c 0a 20 20 ies": "feed",.
0b20: 20 20 22 6b 65 65 70 22 3a 20 7b 0a 20 20 20 20 "keep": {.
0b30: 20 20 22 73 74 64 65 72 72 22 3a 20 22 31 4b 22 "stderr": "1K"
0b40: 0a 20 20 20 20 7d 2c 0a 20 20 20 20 22 65 6e 76 . },. "env
0b50: 22 3a 20 7b 0a 20 20 20 20 20 20 22 48 4f 4d 45 ": {. "HOME
0b60: 22 3a 20 22 24 24 77 6f 72 6b 73 70 61 63 65 24 ": "$$workspace$
0b70: 24 22 2c 0a 20 20 20 20 20 20 22 55 53 45 52 22 $",. "USER"
0b80: 3a 20 22 24 24 75 73 65 72 24 24 22 2c 0a 20 20 : "$$user$$",.
0b90: 20 20 20 20 22 50 41 54 48 22 3a 20 22 24 24 72 "PATH": "$$r
0ba0: 65 6c 65 61 73 65 24 24 3a 2f 75 73 72 2f 6c 6f elease$$:/usr/lo
0bb0: 63 61 6c 2f 62 69 6e 3a 2f 75 73 72 2f 62 69 6e cal/bin:/usr/bin
0bc0: 3a 2f 62 69 6e 22 2c 0a 20 20 20 20 20 20 22 54 :/bin",. "T
0bd0: 45 52 4d 22 3a 20 22 78 74 65 72 6d 2d 32 35 36 ERM": "xterm-256
0be0: 63 6f 6c 6f 72 22 2c 0a 20 20 20 20 20 20 22 49 color",. "I
0bf0: 53 5f 53 41 4e 44 42 4f 58 22 3a 20 22 31 22 0a S_SANDBOX": "1".
0c00: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 60 60 60 0a }. }.}.```.