Skip to content
friel-openaiPublic

About

Lightweight coding agent that runs in your terminal

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

152 Commits

Folders and files

Repository files navigation

Frodex layered fork
===================

Frodex is a small downstream distribution of OpenAI Codex.
This repository keeps its downstream work as stable canonical layers instead
of continually rebasing one rolling source branch.

`layerctl` projects the repository's ordered layers onto an exact Codex
`rust-v*` release.
The resulting Git history has the upstream release as its ancestor and one
generated commit for each Frodex layer, while the canonical layer history
remains stable when upstream changes.

The current definition has 38 layers. Each layer was generated from one
maintained Frodex commit. `layers/0000-foundation/` maps to the first maintained
commit because `layerctl` requires that identifier; it is not an additional
synthetic commit.

Repository layout
-----------------

```text
.github/workflows/      Canonical release automation
layers/NNNN-layer-slug/ Ordered generated commit definitions
cmd/layerctl/           CLI entry point
internal/               layerctl domains and adapters
LAYERCTL.md             Layer maintenance and release operations
tools/                  Canonical repository operations
upstream.json           Current exact Codex base
```

Layer directory names are applied in lexical order.
Their four-digit prefixes are the only ordering mechanism.
Each directory contains the required generated commit message in
`COMMIT_EDITMSG` and an optional binary-safe tree delta in `patch`.
`layers/0000-foundation/` is the required first layer. Its patch and commit
message define the first maintained Frodex commit.

See `LAYERCTL.md` for projection, layer capture, upstream advancement,
verification, and release operations.

The default-branch workflow creates releases from a full projection:

```text
tools/release.sh [-b RELEASE_NOTES]
```

The script only dispatches that workflow. The workflow reads `upstream.json`,
materializes the canonical layers, chooses the next Frodex release number,
publishes the immutable projection tag, builds `codex` and
`codex-code-mode-host` for each platform, and creates the GitHub release.

See `AGENTS.md` for the complete repository operating contract.

About

Lightweight coding agent that runs in your terminal

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages