alexeygrigorev / alexeygrigorev/codex-zcode
Tracking: adopt zcode-core ideas researched from the desktop app
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 0
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
Background
I reverse-engineered the ZCode desktop app and the zcode.cjs core it ships. The full write-ups live in the private zcode-article repo (not published):
- zcode-anatomy.md - binary layout and the extraction pipeline
- ui-core-interaction.md - the UI-to-core pipeline and the fork bridge comparison
- zcode-core-internals.md - the runtime stack, the agent loop, and the goal machine
This issue tracks what to work on next, taken from the "adoptable pieces" sections of that research. (Repo issues were enabled for this.)
Goal-system items (ext/goal)
- #11 - verify completion with a tool-less judge call instead of model self-report
- #13 - stop continuing when there is no actionable next step
- #15 - pause the active goal on user interrupt
- #17 - per-iteration accounting and timeline markers
- #19 - inject status changes at turn-safe points (reminder deferral)
Bridge items (core/src/client.rs)
- #21 - stall timeout on the stream-json pipe plus staged process-tree teardown
- #23 - experiment: keep one core warm across turns of a thread
- #25 - permission mirroring via interaction/* callbacks to replace --mode yolo (depends on #23)
- #27 - compat retry ladder for zcode.cjs version drift
Suggested order
- #15 and #13 - small, independent ext/goal wins
- #11 - bigger; changes goal completion semantics, needs an integration test
- #21 - bridge robustness, independent of goals
- #23 - the experiment that informs #25
- #17 and #19 - polish once 1-3 land
- #25 and #27 - exploratory / defensive
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
This is a tracking issue rather than a single task, with work split between ext/goal and core/src/client.rs. Start with the suggested first items, #15 or #13, and read their individual issue descriptions; the private research write-ups are not available here. Done means selecting one tracked item and completing its separate implementation and validation work.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100