{"id":51684611,"url":"https://github.com/meta-xucong/codex_skill-long-running-task","last_synced_at":"2026-07-15T18:36:06.492Z","repository":{"id":354374717,"uuid":"1220585734","full_name":"meta-xucong/codex_skill-long-running-task","owner":"meta-xucong","description":"codex_skill: long-running Codex task skill and supervisor","archived":false,"fork":false,"pushed_at":"2026-06-05T04:28:04.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T07:16:36.189Z","etag":null,"topics":["codex","codex-skill","long-running-task"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meta-xucong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T04:21:28.000Z","updated_at":"2026-06-05T04:28:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/meta-xucong/codex_skill-long-running-task","commit_stats":null,"previous_names":["meta-xucong/codex_skill-long-running-task"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/meta-xucong/codex_skill-long-running-task","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meta-xucong%2Fcodex_skill-long-running-task","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meta-xucong%2Fcodex_skill-long-running-task/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meta-xucong%2Fcodex_skill-long-running-task/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meta-xucong%2Fcodex_skill-long-running-task/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meta-xucong","download_url":"https://codeload.github.com/meta-xucong/codex_skill-long-running-task/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meta-xucong%2Fcodex_skill-long-running-task/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35517479,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-15T02:00:06.706Z","response_time":131,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["codex","codex-skill","long-running-task"],"created_at":"2026-07-15T18:36:05.743Z","updated_at":"2026-07-15T18:36:06.485Z","avatar_url":"https://github.com/meta-xucong.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# codex_skill: Long Running Task\n\nReusable `codex_skill` plus a Python supervisor for state-driven long-running development tasks.\n\nThe skill teaches Codex how to continue through phases, run tests, debug failures, and stop only when the task is done or blocked. The supervisor handles the outer loop by repeatedly invoking Codex with persistent `.codex-longrun/` state.\n\n## Contents\n\n- `skills/long-running-task/`: Codex skill to install under your Codex skills directory.\n- `supervisor.py`: local convenience entry point.\n- `src/longrun_supervisor/`: Python supervisor package.\n- `examples/longrun.toml`: example run configuration.\n- `docs/long-running-codex-skill-development.md`: design and implementation notes.\n- `tests/`: unit tests.\n\n## Install\n\nClone the repository, then install the supervisor package:\n\n```powershell\npip install -e .\n```\n\nInstall the skill by copying it into your Codex skills directory:\n\n```powershell\n$dest = Join-Path $env:USERPROFILE \".codex\\skills\\long-running-task\"\nRemove-Item -LiteralPath $dest -Recurse -Force -ErrorAction SilentlyContinue\nCopy-Item -LiteralPath \".\\skills\\long-running-task\" -Destination $dest -Recurse\n```\n\nRestart Codex or open a new Codex conversation so the skill metadata is reloaded.\n\n### Windows UTF-8 Note\n\nOn some Windows PowerShell consoles, UTF-8 Chinese text can appear garbled even when the repository files are correct.\n\nBefore treating garbled Chinese output as a repository bug:\n\n- verify the file in VS Code or another UTF-8 aware editor\n- prefer `Get-Content -Encoding utf8` when inspecting files in PowerShell\n- use Python for a direct UTF-8 read when needed, for example `python -c \"from pathlib import Path; print(Path(r'path/to/file').read_text(encoding='utf-8'))\"`\n- do not rewrite or save a file only because raw console output looks garbled\n\nThis is usually a terminal rendering issue, not a file corruption issue.\n\n## Use\n\nFrom a Codex conversation in the target project, say:\n\n```text\nUse long-running-task to keep developing the current project until it is done or blocked.\n```\n\nThe skill uses the current working directory as the project path by default.\n\nYou can also run the supervisor directly:\n\n```powershell\npython supervisor.py --project D:\\path\\to\\project init --objective \"Build and verify the requested feature\"\npython supervisor.py --project D:\\path\\to\\project run --max-iterations 10 --sandbox workspace-write --full-auto\n```\n\nEnvironment diagnostics:\n\n```powershell\npython supervisor.py --project D:\\path\\to\\project doctor\n```\n\nCurrent state and latest run report:\n\n```powershell\npython supervisor.py --project D:\\path\\to\\project report\n```\n\n## Safety\n\nThis project does not bypass Codex safety boundaries or product/runtime limits. It keeps working across normal phase boundaries, but still stops for done state, blockers, missing credentials, destructive operations, repeated unproductive failures, or external limits.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeta-xucong%2Fcodex_skill-long-running-task","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeta-xucong%2Fcodex_skill-long-running-task","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeta-xucong%2Fcodex_skill-long-running-task/lists"}