{"id":50187770,"url":"https://github.com/jeeftor/codex-ha","last_synced_at":"2026-05-25T11:04:55.154Z","repository":{"id":354880144,"uuid":"1225703823","full_name":"jeeftor/codex-ha","owner":"jeeftor","description":"Home Assistant Skills for OpenAI Codex","archived":false,"fork":false,"pushed_at":"2026-05-19T17:05:40.000Z","size":92,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-19T20:41:28.618Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeeftor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-30T14:49:35.000Z","updated_at":"2026-05-19T17:05:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeeftor/codex-ha","commit_stats":null,"previous_names":["jeeftor/codex-ha"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jeeftor/codex-ha","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fcodex-ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fcodex-ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fcodex-ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fcodex-ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeeftor","download_url":"https://codeload.github.com/jeeftor/codex-ha/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fcodex-ha/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33471530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T06:32:55.349Z","status":"ssl_error","status_checked_at":"2026-05-25T06:32:35.322Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-05-25T11:04:50.029Z","updated_at":"2026-05-25T11:04:55.143Z","avatar_url":"https://github.com/jeeftor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Codex HA Skills\n\nCodex HA is a standalone skill bundle for maintaining Home Assistant integrations and their backing Python libraries.\n\nIt installs plain skill names:\n\n- `$ha-init` - discover local Home Assistant repos and write local config\n- `$ha-workflow` - route broad Home Assistant maintainer tasks\n- `$ha-integration` - maintain existing integrations\n- `$ha-library` - update integration backing libraries\n- `$ha-feature` - add integration features\n- `$ha-bugfix` - fix integration or library bugs\n- `$ha-tests` - write focused integration tests\n- `$ha-coverage` - increase integration test coverage\n- `$ha-quality` - route quality scale assessment and improvement work\n- `$ha-quality-audit` - audit quality scale rules and evidence\n- `$ha-quality-improve` - close quality scale gaps with focused implementation, docs, and tests\n- `$ha-pr` - route PR work\n- `$ha-pr-writer` - draft initial HA PR descriptions and required template fields\n- `$ha-copilot-review` - review HA Core changes against generated Copilot instructions before pushing or PR creation\n- `$ha-pr-create` - commit staged changes, push a branch, and create a GitHub PR\n- `$ha-pr-update` - commit and push updates to an open GitHub PR\n- `$ha-pr-table` - summarize and prioritize open HA Core PRs\n- `$ha-pr-watcher` - inspect open PR comments, checks, and requested changes\n- `$ha-sync` - rebase feature branches onto `upstream/dev`\n- `$ha-docs` - update `home-assistant.io` integration docs\n\nSee [agent-matrix.md](agent-matrix.md) for the current skill routing hierarchy.\n\n## Install\n\nRecommended:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/jeeftor/codex-ha/master/scripts/install.sh | sh\n```\n\nFrom a local checkout:\n\n```bash\n./scripts/install.sh\n```\n\nThe installer copies skills to:\n\n```text\n~/.codex/skills/\n```\n\nand shared HA Assistant references/scripts to:\n\n```text\n~/.codex/ha-assistant/\n```\n\nRestart Codex after installation.\n\n## Update\n\nRun the installer again to update an existing install:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/jeeftor/codex-ha/master/scripts/install.sh | sh\n```\n\nIf `ha-*` skills are already installed, the installer shows the existing skill directories and asks before removing them. It then installs the current bundle from scratch and refreshes shared files. This makes updates a clean reinstall.\n\n## First Run\n\nConfigure local Home Assistant paths:\n\n```text\n$ha-init configure my Home Assistant setup. My GitHub handle is jeeftor and my repos are under ~/devel/ha.\n```\n\nThe init skill writes personal config to:\n\n```text\n~/.codex/ha-assistant/config.yaml\n```\n\nThat file is intentionally outside this repo.\n\n## Uninstall\n\nRecommended:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/jeeftor/codex-ha/master/scripts/uninstall.sh | sh\n```\n\nFrom a local checkout:\n\n```bash\n./scripts/uninstall.sh\n```\n\nBy default, uninstall preserves:\n\n```text\n~/.codex/ha-assistant/config.yaml\n```\n\nTo remove the generated config too:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/jeeftor/codex-ha/master/scripts/uninstall.sh | REMOVE_CONFIG=1 sh\n```\n\n## Alternative Install\n\nCodex includes a `skill-installer` workflow that can install skills from GitHub into `$CODEX_HOME/skills`. That is good for one-off, self-contained skills.\n\nThis repo uses an install script because the HA skills share references and helper scripts under `~/.codex/ha-assistant`. Installing only one skill folder from GitHub would not install those shared files.\n\n## Delegation\n\n`$ha-workflow` can route to the specialist skills. When the user explicitly asks for subagents, delegation, or parallel work, it can spawn focused agents and include the target skill in the subagent prompt, such as `Use $ha-tests` or `Use $ha-library`.\n\n## Expected Local Layout\n\nThe skills can discover repos, but they work best with a layout like:\n\n```text\n~/devel/ha/core\n~/devel/ha/home-assistant.io\n~/devel/ha/weatherflow4py\n```\n\nThey map integrations from Home Assistant Core manifests to nearby backing libraries when possible.\n\n## Development\n\nRepository layout:\n\n```text\nskills/\n  ha-init/\n  ha-workflow/\n  ha-quality/\n  ...\nreferences/ha-assistant/\nscripts/\n```\n\nValidate before pushing:\n\n```bash\npython3 -m py_compile scripts/discover_config.py\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-workflow\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-quality\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-quality-audit\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-quality-improve\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-copilot-review\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-pr-update\n~/.codex/codex-python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ha-pr-table\n```\n\n## Notes\n\n- Home Assistant Core code and docs live in separate repositories.\n- The skills read repo-local `AGENTS.md` and `CLAUDE.md` before editing.\n- Branch sync for Home Assistant Core uses `git fetch upstream` and `git rebase upstream/dev`, stopping on dirty worktrees or conflicts.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeeftor%2Fcodex-ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeeftor%2Fcodex-ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeeftor%2Fcodex-ha/lists"}