create-egregore 0.17.3 → 0.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/egregore-launcher.js +1965 -0
- package/assets/egregore-launcher.sh +385 -0
- package/bin/cli.js +472 -81
- package/lib/api.js +3 -3
- package/lib/auth.js +255 -20
- package/lib/codex-runtime.js +268 -0
- package/lib/commands.js +31 -0
- package/lib/context.js +1 -1
- package/lib/local.js +618 -193
- package/lib/setup.js +837 -85
- package/lib/ui.js +780 -84
- package/package.json +17 -4
- package/runtime/codex/.codex/config.toml +15 -0
- package/runtime/codex/.codex/hooks/branch-guard.js +234 -0
- package/runtime/codex/.codex/hooks.json +17 -0
- package/runtime/codex/.codex/skills/activity/SKILL.md +70 -0
- package/runtime/codex/.codex/skills/add/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/announce/SKILL.md +54 -0
- package/runtime/codex/.codex/skills/answer/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/archive/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/ask/SKILL.md +59 -0
- package/runtime/codex/.codex/skills/branch/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/checkup/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/comment/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/commit/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/contribute/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/dark-mode/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/dashboard/SKILL.md +59 -0
- package/runtime/codex/.codex/skills/deep-reflect/SKILL.md +70 -0
- package/runtime/codex/.codex/skills/delete-user/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/edit/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/edit-process/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/egregore-voice/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/emissary/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/env/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/handoff/SKILL.md +67 -0
- package/runtime/codex/.codex/skills/harvest/SKILL.md +107 -0
- package/runtime/codex/.codex/skills/infra/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/ingest/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/ingest-google/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/ingest-user-interview/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/invite/SKILL.md +40 -0
- package/runtime/codex/.codex/skills/issue/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/me/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/meeting/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/note/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/onboarding/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/pr/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/project/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/pull/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/push/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/quest/SKILL.md +77 -0
- package/runtime/codex/.codex/skills/quest-suggest/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/reflect/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/review-pr/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/save/SKILL.md +62 -0
- package/runtime/codex/.codex/skills/setup/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/summon/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/sync-repos/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/telegram-connect/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/telemetry/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/test/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/the-spiral/SKILL.md +84 -0
- package/runtime/codex/.codex/skills/todo/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/tui-design/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/tutorial/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/update/SKILL.md +25 -0
- package/runtime/codex/.codex/skills/view/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/visual-explain/SKILL.md +41 -0
- package/runtime/codex/.codex/skills/wrap/SKILL.md +55 -0
- package/runtime/codex/.codex/spec-manifest.json +108 -0
- package/runtime/codex/AGENTS.md +328 -0
- package/runtime/codex/bin/activity-data.sh +180 -0
- package/runtime/codex/bin/agent.sh +669 -0
- package/runtime/codex/bin/codex-install-skills.sh +78 -0
- package/runtime/codex/bin/codex-render-spec.mjs +308 -0
- package/runtime/codex/bin/codex-session-start.sh +238 -0
- package/runtime/codex/bin/codex-skill-render.mjs +315 -0
- package/runtime/codex/bin/codex-sync-skills.sh +223 -0
- package/runtime/codex/bin/dashboard-data.sh +178 -0
- package/runtime/codex/bin/graph-batch.sh +60 -0
- package/runtime/codex/bin/graph-op.sh +397 -0
- package/runtime/codex/bin/graph-wal.sh +228 -0
- package/runtime/codex/bin/graph.sh +141 -0
- package/runtime/codex/bin/handoff-pr-backfill.sh +86 -0
- package/runtime/codex/bin/handoff-run.sh +569 -0
- package/runtime/codex/bin/handoff-save-egregore.sh +131 -0
- package/runtime/codex/bin/index-handoff.sh +306 -0
- package/runtime/codex/bin/lib/artifact-id.sh +46 -0
- package/runtime/codex/bin/lib/config.sh +71 -0
- package/runtime/codex/bin/lib/context.sh +511 -0
- package/runtime/codex/bin/lib/dashboard-artifact.sh +142 -0
- package/runtime/codex/bin/lib/edit-loopback.mjs +652 -0
- package/runtime/codex/bin/lib/ensure-develop.sh +183 -0
- package/runtime/codex/bin/lib/git-sync.sh +262 -0
- package/runtime/codex/bin/lib/greeting.sh +432 -0
- package/runtime/codex/bin/lib/hash.sh +13 -0
- package/runtime/codex/bin/lib/identity.sh +164 -0
- package/runtime/codex/bin/lib/permissions.sh +106 -0
- package/runtime/codex/bin/lib/time.sh +56 -0
- package/runtime/codex/bin/lib/worktree-links.sh +54 -0
- package/runtime/codex/bin/notify.sh +207 -0
- package/runtime/codex/bin/publish-artifact.sh +187 -0
- package/runtime/codex/bin/publish-references.sh +144 -0
- package/runtime/codex/bin/repo-state.sh +99 -0
- package/runtime/codex/bin/telemetry.sh +350 -0
- package/runtime/codex/bin/worktree-create.sh +115 -0
- package/runtime/codex/bin/worktree-remove.sh +50 -0
- package/runtime/codex/bin/worktree.sh +199 -0
- package/runtime/codex/manifest.json +162 -0
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: summon
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore summon workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore summon Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/summon/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/summon/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: sync-repos
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore sync-repos workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore sync-repos Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
1. Read `.claude/skills/sync-repos/SKILL.md` for the workflow details.
|
|
19
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
20
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
21
|
+
explicitly says they are required.
|
|
22
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
23
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
24
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
25
|
+
handoffs.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: telegram-connect
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore telegram-connect workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore telegram-connect Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
1. Read `.claude/skills/telegram-connect/SKILL.md` for the workflow details.
|
|
19
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
20
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
21
|
+
explicitly says they are required.
|
|
22
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
23
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
24
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
25
|
+
handoffs.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: telemetry
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore telemetry workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore telemetry Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
1. Read `.claude/skills/telemetry/SKILL.md` for the workflow details.
|
|
19
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
20
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
21
|
+
explicitly says they are required.
|
|
22
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
23
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
24
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
25
|
+
handoffs.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: test
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore test workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore test Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/test/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/test/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: the-spiral
|
|
3
|
+
description: Run a Codex-native structured Socratic dialogue when the user invokes /the-spiral or $the-spiral to turn an intuition into rigorous, communicable output.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# The Spiral
|
|
7
|
+
|
|
8
|
+
Native Codex Egregore skill. The Spiral is a stateful Socratic process for
|
|
9
|
+
developing, pressure-testing, and compressing a complex thesis.
|
|
10
|
+
|
|
11
|
+
## Setup
|
|
12
|
+
|
|
13
|
+
Gather three inputs, using structured Codex question tooling when available and
|
|
14
|
+
plain one-at-a-time questions otherwise:
|
|
15
|
+
|
|
16
|
+
1. Domain: what are we spiraling on?
|
|
17
|
+
2. Purpose: what should the process produce?
|
|
18
|
+
3. Known areas: what domains must be covered, if any?
|
|
19
|
+
|
|
20
|
+
Create state files:
|
|
21
|
+
|
|
22
|
+
```text
|
|
23
|
+
spiral_state.json
|
|
24
|
+
spiral_artifacts/ring1
|
|
25
|
+
spiral_artifacts/ring2
|
|
26
|
+
spiral_artifacts/ring3
|
|
27
|
+
spiral_artifacts/ring4
|
|
28
|
+
spiral_artifacts/ring5
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
State includes domain, purpose, addressable space, current ring, current loop,
|
|
32
|
+
artifacts, emerged domains, parked threads, descents, and ring history.
|
|
33
|
+
|
|
34
|
+
## Rings
|
|
35
|
+
|
|
36
|
+
1. Seed: find the irreducible claim. Artifact:
|
|
37
|
+
`spiral_artifacts/ring1/seed.md`.
|
|
38
|
+
2. Territory: map implications, tensions, contradictions, and open questions.
|
|
39
|
+
Artifact: `spiral_artifacts/ring2/territory.md`.
|
|
40
|
+
3. Encounter: ground claims in reality. Research facts when needed and write
|
|
41
|
+
domain artifacts under `spiral_artifacts/ring3/`.
|
|
42
|
+
4. Crucible: test objections and disconfirming evidence. Artifact:
|
|
43
|
+
`spiral_artifacts/ring4/crucible.md`.
|
|
44
|
+
5. Compression: produce the final deliverables under
|
|
45
|
+
`spiral_artifacts/ring5/`.
|
|
46
|
+
|
|
47
|
+
Ask one question at a time. After each alignment check, update
|
|
48
|
+
`spiral_state.json`. Render a compact text progress view only at setup,
|
|
49
|
+
alignment checks, ring transitions, descents, resume, and completion.
|
|
50
|
+
|
|
51
|
+
## TUI Rendering
|
|
52
|
+
|
|
53
|
+
Structured UX parity is required. The Spiral must present state as a structured
|
|
54
|
+
terminal view at phase boundaries, not as loose paragraphs:
|
|
55
|
+
|
|
56
|
+
- Show rings 1-5 with current/completed/parked status.
|
|
57
|
+
- Show current thesis, emerged domains, parked threads, descents, and next
|
|
58
|
+
question or alignment check.
|
|
59
|
+
- Render only at setup, alignment checks, ring transitions, descents, resume,
|
|
60
|
+
and completion.
|
|
61
|
+
- On completion, render a final structured view with rings completed, loop
|
|
62
|
+
count, deliverable paths, emerged domains, and parked threads.
|
|
63
|
+
- Do not render mid-flow while asking a Socratic question.
|
|
64
|
+
|
|
65
|
+
## Flow Rules
|
|
66
|
+
|
|
67
|
+
- If the user gives a marketing-like answer in Ring 1, push toward the real
|
|
68
|
+
conviction.
|
|
69
|
+
- If an objection breaks an earlier assumption, offer a descent to the right
|
|
70
|
+
ring and record the reason.
|
|
71
|
+
- Research is active only when factual claims need grounding or pressure.
|
|
72
|
+
- Never force a domain that has not emerged from the user's answers.
|
|
73
|
+
- If the user is tired or wants to pause, crystallize the current state and
|
|
74
|
+
stop at an alignment boundary.
|
|
75
|
+
|
|
76
|
+
## Resume
|
|
77
|
+
|
|
78
|
+
If `spiral_state.json` exists, summarize domain, ring, loop, and current
|
|
79
|
+
artifacts, then ask whether to continue or start fresh.
|
|
80
|
+
|
|
81
|
+
## Completion
|
|
82
|
+
|
|
83
|
+
The process ends when Ring 5 deliverables satisfy the user. Report artifact
|
|
84
|
+
paths, rings completed, loop count, emerged domains, and any parked threads.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: todo
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore todo workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore todo Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/todo/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/todo/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tui-design
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore tui-design workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore tui-design Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/tui-design/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/tui-design/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tutorial
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore tutorial workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore tutorial Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/tutorial/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/tutorial/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: update
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore update workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore update Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
1. Read `.claude/skills/update/SKILL.md` for the workflow details.
|
|
19
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
20
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
21
|
+
explicitly says they are required.
|
|
22
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
23
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
24
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
25
|
+
handoffs.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: view
|
|
3
|
+
description: 'Fallback Codex adapter for the Egregore view workflow.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore view Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/view/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/view/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: visual-explain
|
|
3
|
+
description: 'Explain concepts visually using ASCII diagrams, flow charts, tables, and structural maps. Use when asked to explain, compare, or show how something works.'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<!-- generated-by: bin/codex-sync-skills.sh -->
|
|
7
|
+
|
|
8
|
+
# Egregore visual-explain Adapter
|
|
9
|
+
|
|
10
|
+
This is fallback coverage for a long-tail Egregore workflow that has not been
|
|
11
|
+
ported to a hand-written Codex-native skill yet.
|
|
12
|
+
|
|
13
|
+
Use the project shell and filesystem directly. Do not invoke Claude Code
|
|
14
|
+
commands. Translate interactive choices to structured Codex question tooling
|
|
15
|
+
when it is available; otherwise render compact numbered choices with an
|
|
16
|
+
`Other:` option and wait for the user.
|
|
17
|
+
|
|
18
|
+
## Structured UX parity
|
|
19
|
+
|
|
20
|
+
This workflow has a Claude skill with user-visible structured output. After
|
|
21
|
+
reading `.claude/skills/visual-explain/SKILL.md`, reproduce the same visible UX in Codex:
|
|
22
|
+
|
|
23
|
+
- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
|
|
24
|
+
exact confirmation blocks, and "no preamble" rules from the source skill.
|
|
25
|
+
- Use the source skill's frame width, section order, labels, status footer,
|
|
26
|
+
and examples as the contract for the final response.
|
|
27
|
+
- Never replace a required box/table/card/artifact view with a prose summary
|
|
28
|
+
unless the user explicitly asks for a summary.
|
|
29
|
+
- When the source says to output a TUI box directly, paste that box as the
|
|
30
|
+
visible response, preferably in a `text` fenced block.
|
|
31
|
+
- Never show raw JSON, raw command output, or unformatted script output when
|
|
32
|
+
the source skill requires formatted status or rendered output.
|
|
33
|
+
|
|
34
|
+
1. Read `.claude/skills/visual-explain/SKILL.md` for the workflow details.
|
|
35
|
+
2. Run the referenced `bin/` scripts directly from Codex.
|
|
36
|
+
3. Treat graph, publish, and notify steps as best-effort unless that workflow
|
|
37
|
+
explicitly says they are required.
|
|
38
|
+
4. Keep local-mode behavior filesystem-first and avoid graph or notification
|
|
39
|
+
calls when `egregore.json` declares `"mode": "local"`.
|
|
40
|
+
5. Never call the deprecated `egregore-handoff` CLI for Egregore project
|
|
41
|
+
handoffs.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: wrap
|
|
3
|
+
description: Wrap an Egregore session when the user invokes /wrap or $wrap, or says they are done, wrapping up, or at a stopping point in Codex.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Egregore Wrap
|
|
7
|
+
|
|
8
|
+
Native Codex Egregore skill. Use this inside an Egregore checkout with
|
|
9
|
+
`bin/agent.sh`.
|
|
10
|
+
|
|
11
|
+
## Flow
|
|
12
|
+
|
|
13
|
+
1. Synthesize a topic, a one to three sentence summary, and concise open notes
|
|
14
|
+
from the current session.
|
|
15
|
+
2. If the session has ambiguous or potentially misleading state, confirm with
|
|
16
|
+
the user. Use structured Codex question tooling when available; otherwise
|
|
17
|
+
show numbered choices plus `Other:` and wait.
|
|
18
|
+
3. Resolve the author from `.egregore-state.json` `github_username`, then
|
|
19
|
+
`name`, then git config.
|
|
20
|
+
4. Write the notes to a temp markdown file.
|
|
21
|
+
5. Run:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
bin/agent.sh wrap --from "$AUTHOR" --topic "$TOPIC" --summary "$SUMMARY" --body-file "$BODY_FILE"
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
6. If `git status --porcelain` reports repo changes after the wrap, run:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
bin/agent.sh save --message "Wrap: $TOPIC" --topic "$TOPIC"
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
7. Report the `memory/wraps/...` path and whether code changes were saved.
|
|
34
|
+
|
|
35
|
+
## Output
|
|
36
|
+
|
|
37
|
+
Structured UX parity is required. Finish with the standard Egregore wrap
|
|
38
|
+
confirmation TUI, not a prose-only summary:
|
|
39
|
+
|
|
40
|
+
- Use a 72-column outer box with only the four standard line patterns:
|
|
41
|
+
top rule, separator rule, content line, bottom rule.
|
|
42
|
+
- Header: `WRAP`, author, and date.
|
|
43
|
+
- Body: topic, one compact summary, open threads or "No open threads", and
|
|
44
|
+
the `memory/wraps/...` path.
|
|
45
|
+
- Footer: saved/pushed status. If code changes were saved, show that. If the
|
|
46
|
+
wrap only touched memory, say so.
|
|
47
|
+
- Output the box directly, preferably in a `text` fenced block, with no
|
|
48
|
+
narration before it.
|
|
49
|
+
|
|
50
|
+
## Rules
|
|
51
|
+
|
|
52
|
+
- Do not use Claude Code commands.
|
|
53
|
+
- Do not invent finished work. Separate completed work, verification, and open
|
|
54
|
+
follow-ups.
|
|
55
|
+
- If save fails, report the failure and leave the local commits untouched.
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
{
|
|
2
|
+
"generatedBy": "bin/codex-render-spec.mjs",
|
|
3
|
+
"source": "CLAUDE.md",
|
|
4
|
+
"sections": [
|
|
5
|
+
{
|
|
6
|
+
"section": "(intro)",
|
|
7
|
+
"action": "replace",
|
|
8
|
+
"sourceHash": "3992e3abfcdd",
|
|
9
|
+
"note": "Reframed for Codex: names AGENTS.md as the delivery surface and the manifest; \"organizations using Claude Code\" generalized."
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"section": "Identity & Upstream",
|
|
13
|
+
"action": "keep",
|
|
14
|
+
"sourceHash": "4acbf9bc2866",
|
|
15
|
+
"note": "Kept; /update, /contribute, /save tokens rendered as $skill tokens."
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"section": "On Launch — MANDATORY FIRST ACTION",
|
|
19
|
+
"action": "replace",
|
|
20
|
+
"sourceHash": "d2f6595756c8",
|
|
21
|
+
"note": "Claude SessionStart hook does not run on Codex; the egregore launcher renders the card via bin/codex-session-start.sh before the session. Greeting-replay instruction dropped (card is already on screen)."
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
"section": "After Greeting — BRANCH ON FIRST RESPONSE",
|
|
25
|
+
"action": "replace",
|
|
26
|
+
"sourceHash": "09c2618759bd",
|
|
27
|
+
"note": "EnterWorktree -> bin/agent.sh branch with git checkout fallback; AskUserQuestion -> numbered options in plain text; branch-guard mapped to .codex/hooks/branch-guard.js with instruction fallback; plan-mode note dropped (no plan mode on Codex); /branch + /onboarding -> skill tokens. Handoff claiming and repoState auto-checkout kept verbatim (pure git)."
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"section": "Config Files",
|
|
31
|
+
"action": "keep",
|
|
32
|
+
"sourceHash": "81b7bf09901b",
|
|
33
|
+
"note": "Kept verbatim — shell facts, runtime-neutral."
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"section": "Knowledge Graph",
|
|
37
|
+
"action": "keep",
|
|
38
|
+
"sourceHash": "5c0953aee955",
|
|
39
|
+
"note": "Kept verbatim — bin/graph.sh is runtime-neutral."
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"section": "Notifications",
|
|
43
|
+
"action": "keep",
|
|
44
|
+
"sourceHash": "e155d669f5bd",
|
|
45
|
+
"note": "Kept verbatim — bin/notify.sh is runtime-neutral."
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"section": "Onboarding",
|
|
49
|
+
"action": "keep",
|
|
50
|
+
"sourceHash": "ee3ecb296252",
|
|
51
|
+
"note": "Kept; /onboarding rendered as $onboarding."
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
"section": "Transparency Beat",
|
|
55
|
+
"action": "keep",
|
|
56
|
+
"sourceHash": "e06da653d3ad",
|
|
57
|
+
"note": "Kept verbatim."
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"section": "Memory",
|
|
61
|
+
"action": "keep",
|
|
62
|
+
"sourceHash": "d75dc9f6d88c",
|
|
63
|
+
"note": "Kept verbatim."
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
"section": "Git Workflow",
|
|
67
|
+
"action": "keep",
|
|
68
|
+
"sourceHash": "d058d1f8da11",
|
|
69
|
+
"note": "Kept; slash tokens rendered as $skill tokens. Branch diagram unchanged (code fence)."
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"section": "Working Conventions",
|
|
73
|
+
"action": "keep",
|
|
74
|
+
"sourceHash": "37a5318e9ee0",
|
|
75
|
+
"note": "Kept verbatim."
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"section": "Command Awareness",
|
|
79
|
+
"action": "keep",
|
|
80
|
+
"sourceHash": "d3ea48ebf938",
|
|
81
|
+
"note": "Prepended the Codex command surface (skill tokens, native vs adapter split, $save abstraction); disambiguation map kept with /x -> $x token rendering. Tokens with no Codex skill (e.g. /loop, a Claude Code harness feature) are left as-is."
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"section": "Socratic Questioning (MANDATORY)",
|
|
85
|
+
"action": "replace",
|
|
86
|
+
"sourceHash": "febe45868016",
|
|
87
|
+
"note": "AskUserQuestion -> numbered plain-text question batches with explicit stop-and-wait; multiSelect -> \"pick any that apply\"."
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"section": "Telemetry",
|
|
91
|
+
"action": "keep",
|
|
92
|
+
"sourceHash": "f8b242d0fd64",
|
|
93
|
+
"note": "Kept verbatim — bin/telemetry.sh is runtime-neutral."
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"section": "Mode",
|
|
97
|
+
"action": "keep",
|
|
98
|
+
"sourceHash": "ae5cbb9c5d30",
|
|
99
|
+
"note": "Kept; /env and /checkup rendered as $skill tokens."
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"section": "Environment Isolation",
|
|
103
|
+
"action": "replace",
|
|
104
|
+
"sourceHash": "ed47e96248bd",
|
|
105
|
+
"note": "boundary-check is a Claude PreToolUse hook with no .codex equivalent — behavior stated as a standing instruction; AskUserQuestion remediation -> numbered options."
|
|
106
|
+
}
|
|
107
|
+
]
|
|
108
|
+
}
|