codexloop 0.1.0__tar.gz

codexloop-0.1.0/.agents/skills/codexloop-run/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: codexloop-run
+description: Run and debug codexloop autonomous sessions.
+---
+
+# codexloop-run
+
+1. `codexloop doctor` before a long run.
+2. Prefer `--transport exec` unless you need interrupt/steer.
+3. Never pass `--full-auto`. Never invoke bare `codex`.
+4. Capacity waits are probe-driven; billing walls (`insufficient_quota`) are terminal.
+5. After SDK upgrades, refresh `api_baseline.json` only when intentional.

codexloop-0.1.0/.claude/skills/codexloop-run/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: codexloop-run
+description: Run and debug codexloop autonomous sessions.
+---
+
+# codexloop-run
+
+1. `codexloop doctor` before a long run.
+2. Prefer `--transport exec` unless you need interrupt/steer.
+3. Never pass `--full-auto`. Never invoke bare `codex`.
+4. Capacity waits are probe-driven; billing walls (`insufficient_quota`) are terminal.
+5. After SDK upgrades, refresh `api_baseline.json` only when intentional.

codexloop-0.1.0/.cursor/rules/codexloop-run.mdc

@@ -0,0 +1,13 @@
+---
+description: Run and debug codexloop autonomous sessions.
+globs:
+alwaysApply: false
+---
+
+# codexloop-run
+
+1. `codexloop doctor` before a long run.
+2. Prefer `--transport exec` unless you need interrupt/steer.
+3. Never pass `--full-auto`. Never invoke bare `codex`.
+4. Capacity waits are probe-driven; billing walls (`insufficient_quota`) are terminal.
+5. After SDK upgrades, refresh `api_baseline.json` only when intentional.

codexloop-0.1.0/.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+indent_style = space
+indent_size = 4
+
+[*.py]
+max_line_length = 100
+
+[*.{yml,yaml,json}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+[Makefile]
+indent_style = tab

codexloop-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default owners for the whole repository.
+* @adammatthewsteinberger

codexloop-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,59 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    name: Gates py${{ matrix.python-version }} / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[dev]"
+      - run: ruff check src tests
+      - run: ruff format --check src tests
+      - run: mypy src/codexloop
+      - run: lint-imports
+      - run: bandit -q -r src/codexloop
+      - run: pip-audit
+      - run: pytest --cov-report=term-missing
+
+  build:
+    name: Package builds and is installable
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - name: Confirm py.typed ships in the wheel
+        run: unzip -l dist/*.whl | grep -q py.typed
+      - name: Install the built wheel into a clean venv and run the console script
+        run: |
+          python -m venv /tmp/codexloop-smoke
+          /tmp/codexloop-smoke/bin/pip install --upgrade pip
+          /tmp/codexloop-smoke/bin/pip install dist/*.whl
+          /tmp/codexloop-smoke/bin/codexloop --version
+          /tmp/codexloop-smoke/bin/codexloop --help

codexloop-0.1.0/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,35 @@
+name: Publish TestPyPI
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [develop]
+
+permissions:
+  contents: read
+  id-token: write
+
+concurrency:
+  group: testpypi-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  publish:
+    name: Build and publish to TestPyPI
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          packages-dir: dist/
+          skip-existing: true
+          print-hash: true

codexloop-0.1.0/.github/workflows/release-please.yml

@@ -0,0 +1,75 @@
+name: release-please
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      publish_to_testpypi:
+        description: "Also build and publish this commit to TestPyPI (Trusted Publishing)."
+        type: boolean
+        default: false
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          release-type: python
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  publish-pypi:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created == 'true' }}
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.release-please.outputs.tag_name }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          print-hash: true
+
+  publish-testpypi-manual:
+    if: ${{ github.event_name == 'workflow_dispatch' && inputs.publish_to_testpypi }}
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          packages-dir: dist/
+          skip-existing: true
+          print-hash: true

codexloop-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+wheels/
+pip-wheel-metadata/
+
+# --- Virtual environments ---
+.venv/
+venv/
+env/
+ENV/
+
+# --- Test / coverage / type-check / lint caches ---
+.pytest_cache/
+.hypothesis/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.ruff_cache/
+.import_linter_cache/
+.tox/
+.nox/
+
+# --- Docs build output ---
+site/
+
+# --- Editors / OS ---
+.vscode/
+.idea/
+*.swp
+.DS_Store
+
+# --- Local run state ---
+.codexloop/
+
+# --- SDD scratch ---
+.superpowers/

codexloop-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,72 @@
+# Install once per clone with:  pre-commit install
+# That single command wires up BOTH hook types below — no extra flags needed,
+# because of `default_install_hook_types`.
+default_install_hook_types: [pre-commit, commit-msg]
+
+repos:
+  # --- Lint / format ---
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.16.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  # --- Generic file hygiene ---
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: [--maxkb=1024]
+      - id: check-yaml
+      - id: check-toml
+      - id: check-case-conflict
+      - id: mixed-line-ending
+        args: [--fix=lf]
+      - id: debug-statements
+
+  # --- Conventional Commits, enforced at commit-msg time ---
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.4.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args:
+          - --strict
+          - feat
+          - fix
+          - docs
+          - style
+          - refactor
+          - perf
+          - test
+          - build
+          - ci
+          - chore
+          - revert
+
+  # --- Type checking and security, run locally against the project venv ---
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy --strict
+        entry: mypy
+        language: system
+        types: [python]
+        pass_filenames: false
+        args: [src/codexloop]
+      - id: bandit
+        name: bandit
+        entry: bandit
+        language: system
+        types: [python]
+        pass_filenames: false
+        args: [-q, -r, src/codexloop]
+      - id: import-linter
+        name: import-linter (onion contract)
+        entry: lint-imports
+        language: system
+        pass_filenames: false

codexloop-0.1.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

codexloop-0.1.0/AGENTS.md

@@ -0,0 +1,10 @@
+# AGENTS.md — codexloop
+
+Facts for coding agents (not procedures).
+
+- Onion: domain (stdlib) → application → infrastructure → cli; only `bootstrap.py` spans layers.
+- No `anthropic` / `claude-agent-sdk` / `claudeloop` anywhere under `src/`.
+- `QuotaExhausted` has no reset field. Body-first classification. Never `--full-auto`. Never bare `codex`.
+- Default pytest: `-m "not live and not system"`.
+- Generated REST: `codexloop api` + `api_baseline.json` drift gate.
+- App-server transport is optional and falls back to exec.

codexloop-0.1.0/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+## 0.1.0 (2026-08-13)
+
+
+### Features
+
+* add app-server rate-limit probe client ([a30ef93](https://github.com/adammatthewsteinberger/codexloop/commit/a30ef9377685ef9aea8f5096e1759b0f6293574e))
+* add application ports and fakes ([33e721d](https://github.com/adammatthewsteinberger/codexloop/commit/33e721d0dab21b38c614ab71ea7c3e47a8126fb3))
+* add autonomous runner and run/resume use cases ([bd36f45](https://github.com/adammatthewsteinberger/codexloop/commit/bd36f457548c5969f0fd37453c2d1ab5727d3302))
+* add backoff and adaptive wait policy ([43c70c6](https://github.com/adammatthewsteinberger/codexloop/commit/43c70c68396255e10c61907497c53dd0d1c2ba63))
+* add bootstrap and core CLI commands ([6b6aafc](https://github.com/adammatthewsteinberger/codexloop/commit/6b6aafc94f8d2513282389f154682b1b5a97bcee))
+* add capacity value objects ([1aa3fed](https://github.com/adammatthewsteinberger/codexloop/commit/1aa3fede743d6c5db518f869d03826788c64da5b))
+* add clock, logging, config, rundir, state, and lock adapters ([8f7e4ad](https://github.com/adammatthewsteinberger/codexloop/commit/8f7e4ad1aad0f9a754e7ff5777898bfe5a35c5cd))
+* add codex argv builder ([42ab842](https://github.com/adammatthewsteinberger/codexloop/commit/42ab8426e676b0c6b59bb655bfc94e4a607338ba))
+* add control plane, savepoints, and ops CLI ([512e03f](https://github.com/adammatthewsteinberger/codexloop/commit/512e03f24eddf226425326b992eacc4732f1bc7b))
+* add ephemeral read-only exec capacity probe ([427620b](https://github.com/adammatthewsteinberger/codexloop/commit/427620bda645389caf571bcef010d269d3457093))
+* add error hierarchy and OpenAI error-code taxonomy ([1bf5aa2](https://github.com/adammatthewsteinberger/codexloop/commit/1bf5aa2f2805c80aeba0f37fbe6da1dcb4a59585))
+* add generated OpenAI REST CLI surface with drift gate ([53320f8](https://github.com/adammatthewsteinberger/codexloop/commit/53320f82512869b43075d6eeaf3f6fe73a06a3dd))
+* add optional app-server gateway, stream UI, docs, and release scaffolding ([23bfddf](https://github.com/adammatthewsteinberger/codexloop/commit/23bfddfb169cfb37e8fe60a9a80bd7f9b644bba9))
+* add plan, budget, session, profile, approval, and control types ([07a8188](https://github.com/adammatthewsteinberger/codexloop/commit/07a8188207fa6fbac5f85114d891b266b6be1bf9))
+* add read-only CODEX_HOME rollout tail ([071d6ab](https://github.com/adammatthewsteinberger/codexloop/commit/071d6abe526935893d7d330909e96a308e5203b2))
+* add run-loop state machine ([582144f](https://github.com/adammatthewsteinberger/codexloop/commit/582144fcd2b5d3c327f6af36c74307a9a8818966))
+* add scripted system harness and test-agent gate ([68a7ebf](https://github.com/adammatthewsteinberger/codexloop/commit/68a7ebf9483013f5e7fae4ff98ff2b0f5da843f0))
+* add three-layer completion evaluation ([eee2cc3](https://github.com/adammatthewsteinberger/codexloop/commit/eee2cc3a70562126c438e1a1ba842abca9aa0db6))
+* classify turn signals into capacity states ([f7c4162](https://github.com/adammatthewsteinberger/codexloop/commit/f7c4162048b62f83a7b7ea3f99474605f18376ef))
+* implement codexloop M1–M5 (onion runner + REST + docs) ([1dbef91](https://github.com/adammatthewsteinberger/codexloop/commit/1dbef9118097d8b8210f6a770df8c4c05956f6ce))
+* parse codex exec JSONL events ([1cdc76c](https://github.com/adammatthewsteinberger/codexloop/commit/1cdc76c754f0e0f023f7dc94472be59f9776d3f5))
+* supervise codex subprocess with concurrent pumps ([1c95f6e](https://github.com/adammatthewsteinberger/codexloop/commit/1c95f6e6fe628daefe0256e5ba5fb921bfd595a5))
+* translate JSONL and drive codex exec gateway ([6a1842c](https://github.com/adammatthewsteinberger/codexloop/commit/6a1842c3bab3b9eb57d052b2bb8f1c45b919b69f))
+* wire composite capacity probe and adaptive wait loop ([ab682b1](https://github.com/adammatthewsteinberger/codexloop/commit/ab682b16130829e3ae7a523597213c33509dec22))
+
+
+### Bug Fixes
+
+* jitter throttle waits above Retry-After ([666a4e6](https://github.com/adammatthewsteinberger/codexloop/commit/666a4e6c3d73f277946e866d33866091c225e1c8))
+* only break session locks for known-dead pids ([712b0f4](https://github.com/adammatthewsteinberger/codexloop/commit/712b0f4a4b25d83ba27c0ca53d8278e6961efbd9))
+* preserve remaining work across capacity-rejected turns ([d2d10c3](https://github.com/adammatthewsteinberger/codexloop/commit/d2d10c36a93084a36f48509433d9bb6865172fde))
+* seal onion contracts and order drain before signals ([cecf827](https://github.com/adammatthewsteinberger/codexloop/commit/cecf827e841d11df0fb34c71724415970da3ab7d))
+* stabilize CI help and process-group cancel tests ([3fe2c6d](https://github.com/adammatthewsteinberger/codexloop/commit/3fe2c6d09f94adb0de528a74364a0d9d177ee77b))
+* terminate fatals, apply mid-run controls, harden ops edges ([9171835](https://github.com/adammatthewsteinberger/codexloop/commit/91718359a07f5e25ffd1366c7ea8bbfba51b0a01))
+* treat ControlCommand as the inbox union and wrap parse errors ([0885204](https://github.com/adammatthewsteinberger/codexloop/commit/08852040d2a48a14eb5b7b750fa5d02bb9314e4b))

codexloop-0.1.0/CLAUDE.md

@@ -0,0 +1,5 @@
+# CLAUDE.md
+
+Router for Claude Code. Canonical agent facts live in [AGENTS.md](AGENTS.md).
+Shared procedures: `.claude/skills/codexloop-run/SKILL.md` (mirrored under
+`.agents/skills/` and `.cursor/rules/`).

codexloop-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,4 @@
+# Code of Conduct
+
+Be respectful. Harassment and discrimination are not tolerated.
+Report concerns to the maintainers. Inspired by the Contributor Covenant.

codexloop-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing
+
+## Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,docs]"
+pre-commit install
+```
+
+## Tests
+
+```bash
+pytest                         # default: not live and not system
+pytest -m system               # scripted system harness
+pytest -m live                 # real Codex account (opt-in)
+```
+
+Coverage floors: whole package 100% (`pytest --cov=codexloop --cov-fail-under=100`).
+
+## Commits
+
+Conventional Commits (`feat:`, `fix:`, `test:`, `chore:`, `docs:`).
+
+## Publishing
+
+See [docs/publishing.md](docs/publishing.md) for TestPyPI → PyPI Trusted
+Publishing, GitHub Environments, and the release-please flow.

codexloop-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Matthew Steinberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codexloop-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.5
+Name: codexloop
+Version: 0.1.0
+Summary: Onion-architected, autonomous OpenAI Codex session runner — never blocks on a human, distinguishes rate limits from exhausted credits, and resumes safely across usage windows.
+Project-URL: Homepage, https://github.com/adammatthewsteinberger/codexloop
+Project-URL: Repository, https://github.com/adammatthewsteinberger/codexloop
+Project-URL: Documentation, https://adammatthewsteinberger.github.io/codexloop/
+Project-URL: Issues, https://github.com/adammatthewsteinberger/codexloop/issues
+Project-URL: Changelog, https://github.com/adammatthewsteinberger/codexloop/blob/main/CHANGELOG.md
+Author-email: Adam Matthew Steinberger <adam@matthewsteinberger.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,automation,cli,codex,gpt,llm,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: anyio>=4.0
+Requires-Dist: openai>=1.40
+Requires-Dist: structlog>=24.1
+Requires-Dist: textual>=1.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7; extra == 'dev'
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: import-linter>=2.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: packaging>=24.0; extra == 'dev'
+Requires-Dist: pip-audit>=2.7; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# codexloop
+
+Autonomous OpenAI Codex / GPT session runner. Same job as
+[claudeloop](https://github.com/adammatthewsteinberger/claudeloop): never block on
+a human, and never treat `insufficient_quota` / billing as a waitable
+`rate_limit_exceeded` window.
+
+**Status:** M1–M5 implemented on `feat/m1-pure-core` (onion core, exec gateway,
+capacity probes, control plane, generated REST CLI, optional app-server transport
+with exec fallback). MIT-licensed; author Adam Matthew Steinberger.
+
+## Install
+
+```bash
+pip install -e ".[dev]"
+codexloop --version
+codexloop doctor
+```
+
+## Quick start
+
+```bash
+codexloop run path/to/plan.md
+codexloop watch --follow
+codexloop stop
+```
+
+## Plans
+
+| Document | Purpose |
+|---|---|
+| [docs/plans/architecture-and-roadmap.md](docs/plans/architecture-and-roadmap.md) | Full design / transplant plan from claudeloop 0.5.4 |
+| [docs/plans/research-notes.md](docs/plans/research-notes.md) | Vendor SDK/CLI capacity + autonomy research |
+| [docs/plans/_shared-transplant-outline.md](docs/plans/_shared-transplant-outline.md) | Cross-product keep/swap + Global Constraints |
+| [docs/superpowers/plans/2026-08-13-codexloop-implementation.md](docs/superpowers/plans/2026-08-13-codexloop-implementation.md) | Bite-sized TDD implementation plan |
+
+## Naming
+
+| Item | Value |
+|---|---|
+| PyPI / CLI | `codexloop` |
+| Env prefix | `CODEXLOOP_*` |
+| State dir | `.codexloop/` |
+| Done marker | `CODEXLOOP_TASK_FULLY_COMPLETE` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Publishing
+
+Releases go **TestPyPI → PyPI** via Trusted Publishing. See
+[docs/publishing.md](docs/publishing.md).

codexloop-0.1.0/README.md

@@ -0,0 +1,53 @@
+# codexloop
+
+Autonomous OpenAI Codex / GPT session runner. Same job as
+[claudeloop](https://github.com/adammatthewsteinberger/claudeloop): never block on
+a human, and never treat `insufficient_quota` / billing as a waitable
+`rate_limit_exceeded` window.
+
+**Status:** M1–M5 implemented on `feat/m1-pure-core` (onion core, exec gateway,
+capacity probes, control plane, generated REST CLI, optional app-server transport
+with exec fallback). MIT-licensed; author Adam Matthew Steinberger.
+
+## Install
+
+```bash
+pip install -e ".[dev]"
+codexloop --version
+codexloop doctor
+```
+
+## Quick start
+
+```bash
+codexloop run path/to/plan.md
+codexloop watch --follow
+codexloop stop
+```
+
+## Plans
+
+| Document | Purpose |
+|---|---|
+| [docs/plans/architecture-and-roadmap.md](docs/plans/architecture-and-roadmap.md) | Full design / transplant plan from claudeloop 0.5.4 |
+| [docs/plans/research-notes.md](docs/plans/research-notes.md) | Vendor SDK/CLI capacity + autonomy research |
+| [docs/plans/_shared-transplant-outline.md](docs/plans/_shared-transplant-outline.md) | Cross-product keep/swap + Global Constraints |
+| [docs/superpowers/plans/2026-08-13-codexloop-implementation.md](docs/superpowers/plans/2026-08-13-codexloop-implementation.md) | Bite-sized TDD implementation plan |
+
+## Naming
+
+| Item | Value |
+|---|---|
+| PyPI / CLI | `codexloop` |
+| Env prefix | `CODEXLOOP_*` |
+| State dir | `.codexloop/` |
+| Done marker | `CODEXLOOP_TASK_FULLY_COMPLETE` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Publishing
+
+Releases go **TestPyPI → PyPI** via Trusted Publishing. See
+[docs/publishing.md](docs/publishing.md).

codexloop-0.1.0/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Reporting a vulnerability
+
+Email the maintainers privately. Do not open a public issue for secrets,
+credential leaks, or sandbox escapes.
+
+## Hardening notes
+
+- Default sandbox is `workspace-write` with `approval_policy=never`.
+- `danger-full-access` requires an explicit opt-in and refuses root / non-git cwd.
+- Logs redact API keys and `auth.json` material.
+- Never invoke bare `codex` or `--full-auto`.

codexloop-0.1.0/docs/architecture/adr/0001-onion-import-linter.md

@@ -0,0 +1,17 @@
+# ADR 0001 — Onion architecture enforced by import-linter
+
+## Status
+
+Accepted
+
+## Context
+
+Recorded from the architecture seed list.
+
+## Decision
+
+Keep domain pure and prevent layer leaks via import-linter contracts.
+
+## Consequences
+
+Documented in the architecture roadmap; CI enforces the load-bearing ones.