{"id":51476955,"url":"https://github.com/mastertyko/omp-codex-computer","last_synced_at":"2026-07-06T22:00:58.292Z","repository":{"id":369577437,"uuid":"1290208668","full_name":"mastertyko/omp-codex-computer","owner":"mastertyko","description":null,"archived":false,"fork":false,"pushed_at":"2026-07-06T00:33:57.000Z","size":135,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-06T02:11:04.325Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/mastertyko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-07-05T17:44:40.000Z","updated_at":"2026-07-06T00:26:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mastertyko/omp-codex-computer","commit_stats":null,"previous_names":["mastertyko/omp-codex-computer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mastertyko/omp-codex-computer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastertyko%2Fomp-codex-computer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastertyko%2Fomp-codex-computer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastertyko%2Fomp-codex-computer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastertyko%2Fomp-codex-computer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mastertyko","download_url":"https://codeload.github.com/mastertyko/omp-codex-computer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastertyko%2Fomp-codex-computer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35206987,"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-06T02:00:07.184Z","response_time":106,"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":[],"created_at":"2026-07-06T22:00:57.661Z","updated_at":"2026-07-06T22:00:58.275Z","avatar_url":"https://github.com/mastertyko.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# omp-codex-computer\n\nLocal OMP extension that exposes OpenAI Codex Computer Use through `codex app-server`.\n\n## Requirements\n\n- macOS\n- Codex CLI on `PATH` as `codex`\n- Codex.app installed with Codex Computer Use enabled/available\n- OMP installed\n- Accessibility and Screen Recording permissions granted when Codex Computer Use asks\n- Bundled `computer-use` Codex plugin available in Codex.app; this extension cannot operate without it\n\n## Installation\n\nInstall the npm package through OMP:\n\n```bash\nomp install omp-codex-computer\n```\n\nFor private pre-release testing from GitHub over SSH:\n\n```bash\nomp install git@github.com:mastertyko/omp-codex-computer.git\n```\n\nFor local development, link the working tree into OMP and keep checks green:\n\n```bash\nomp install .\nbun install\nbun run check\n```\n\nInside OMP:\n\n```text\n/codex-computer status\n/codex-computer diagnose\n```\n\nThe extension registers `computer_use_*` tools for native macOS app inspection and interaction through Codex Computer Use, plus a local `computer_use_resolve_app` diagnostic tool that helps identify bad app targets before control actions.\n\nUse `omp-dev -e .` for a local smoke test without installing the package.\n\n## Uninstallation\n\nUninstall the OMP plugin by package/plugin name:\n\n```bash\nomp plugin uninstall omp-codex-computer\n```\n\nUse `omp plugin list` to confirm the plugin is no longer installed.\n\n## Commands\n\n- `/codex-computer status` — checks Codex CLI/app, the bundled `computer-use` plugin, required MCP tools, and reports additional upstream MCP tools not exposed by this adapter.\n- `/codex-computer diagnose` — prints the same detailed readiness/update report.\n- `/codex-computer enable` — enables the `computer_use_*` tools.\n- `/codex-computer disable` — disables the `computer_use_*` tools and shuts down the runtime.\n- `/codex-computer restart`\n- `/codex-computer hide-status` — hides the `Codex 💻: …` footer status for the current extension instance.\n- `/codex-computer show-status` — shows the footer status again.\n\nSet `OMP_CODEX_COMPUTER_STATUS=off` before starting OMP to default the footer status to hidden.\n\n## Safety\n\nThe extension does not automate the desktop directly. It calls Codex app-server, which owns the bundled plugin lifecycle and permission flow. Permission requests fail closed when OMP has no UI available.\n\nDesktop tasks should start with read-only discovery such as `computer_use_list_apps`, `computer_use_resolve_app`, or `computer_use_get_app_state`. If `get_app_state` returns `Invalid app`, the adapter enriches the error with target-resolution guidance for cases like unbundled local GUI processes launched as raw executables. Mutating tools are registered with write approval, and the bundled `codex-computer` skill tells the model to verify after clicks, typing, scrolling, dragging, and value changes.\n\n## Contributing and security\n\n- See [CONTRIBUTING.md](CONTRIBUTING.md) for the local development workflow and pull request expectations.\n- See [SECURITY.md](SECURITY.md) for supported versions and responsible disclosure guidance.\n\n## Verification\n\nLocal automated checks:\n\n```bash\nbun run check\n```\n\nLocal OMP smoke:\n\n```bash\nomp-dev -e .\n/codex-computer diagnose\n```\n\nVerified on 2026-07-05 with OMP v16.3.6 and Codex CLI 0.142.5:\n\n- `bun run check` passed with 83 tests.\n- `/codex-computer diagnose` reported Codex Computer Use ready.\n- A safe `computer_use_list_apps` model path listed available apps.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastertyko%2Fomp-codex-computer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmastertyko%2Fomp-codex-computer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastertyko%2Fomp-codex-computer/lists"}