{"id":35370165,"url":"https://github.com/kdcokenny/ocx","last_synced_at":"2026-04-03T06:04:25.882Z","repository":{"id":331959234,"uuid":"1124360434","full_name":"kdcokenny/ocx","owner":"kdcokenny","description":"OpenCode extension manager with portable, isolated profiles. Work anywhere with your config.","archived":false,"fork":false,"pushed_at":"2026-01-24T03:21:06.000Z","size":1700,"stargazers_count":89,"open_issues_count":19,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-24T12:38:44.126Z","etag":null,"topics":["ai-agents","bun","cli","ocx","opencode","package-manager","shadcn","typescript"],"latest_commit_sha":null,"homepage":"https://kdco.dev","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/kdcokenny.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-28T22:05:08.000Z","updated_at":"2026-01-24T03:22:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kdcokenny/ocx","commit_stats":null,"previous_names":["kdcokenny/ocx"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/kdcokenny/ocx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcokenny%2Focx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcokenny%2Focx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcokenny%2Focx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcokenny%2Focx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdcokenny","download_url":"https://codeload.github.com/kdcokenny/ocx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcokenny%2Focx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28801819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T03:44:14.111Z","status":"ssl_error","status_checked_at":"2026-01-27T03:43:33.507Z","response_time":168,"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":["ai-agents","bun","cli","ocx","opencode","package-manager","shadcn","typescript"],"created_at":"2026-01-02T02:52:54.155Z","updated_at":"2026-04-03T06:04:25.869Z","avatar_url":"https://github.com/kdcokenny.png","language":"TypeScript","funding_links":[],"categories":["AI","TypeScript","Feature Dimensions"],"sub_categories":["1. Sidebar \u0026 Status Pills"],"readme":"# OCX\n\n[![CI](https://github.com/kdcokenny/ocx/actions/workflows/ci.yml/badge.svg)](https://github.com/kdcokenny/ocx/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/ocx.svg)](https://www.npmjs.com/package/ocx)\n[![License](https://img.shields.io/github/license/kdcokenny/ocx.svg)](https://github.com/kdcokenny/ocx/blob/main/LICENSE)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/kdcokenny/ocx)\n\nYour OpenCode config, anywhere.\n\n## Why OCX?\n\n- 📁 **Profiles** — Work in any repo with YOUR config. Control exactly what OpenCode sees.\n- 📦 **Registries** — Install profiles and components from curated registries.\n- 🔒 **Auditable** — SHA-verified, code you own.\n\n![OCX Profiles Demo](./assets/profiles-demo.gif)\n\n*Demo uses [oh-my-opencode](https://ocx.kdco.dev/docs/guides/oh-my-opencode). See [more guides](https://ocx.kdco.dev/docs/guides/index).*\n\n## Installation\n\nOCX supports macOS (x64, Apple Silicon), Linux (x64, arm64), and Windows (x64).\n\n```bash\n# Recommended (macOS/Linux)\ncurl -fsSL https://ocx.kdco.dev/install.sh | sh\n\n# Or via npm (any platform)\nnpm install -g ocx\n```\n\nThe install script handles PATH configuration automatically or prints instructions if manual setup is needed.\n\n## Quick Start\n\nWork in any repo without modifying it. Your config, their code.\n\n```bash\n# One-time setup\nocx init --global\n\n# Install the KDCO workspace profile (OpenCode Free Models Only)\nocx profile add ws --source tweak/p-1vp4xoqv --from https://tweakoc.com/r --global\n\n# Launch OpenCode with the profile\nocx oc -p ws\n```\n\nNeed a custom profile? Open the KDCO Workspace harness in TweakOC: https://tweakoc.com/h/kdco-workspace\n\nProfiles control what OpenCode sees through `exclude`/`include` patterns. Each profile has isolated registries for security. OpenCode config merges safely between profile and local settings.\n\n\u003e **Security Note:** An empty exclude list includes all project instruction files; the default profile template ships a secure exclude list. For trusted repos, edit your profile to loosen the template's exclude list. See [Lock Down Recipe](https://ocx.kdco.dev/docs/profiles/security#lock-down-recipe).\n\n**[Profile Deep Dive →](https://ocx.kdco.dev/docs/profiles/overview)**\n\n## Common Commands\n\n| Command | Description |\n|---------|-------------|\n| `ocx profile add \u003cname\u003e --source \u003cregistry/profile\u003e --from \u003curl\u003e --global` | Install a profile from a registry |\n| `ocx profile add \u003cname\u003e --clone \u003cexisting\u003e --global` | Clone an existing profile |\n| `ocx oc -p \u003cname\u003e` | Launch OpenCode with a profile |\n| `ocx profile list --global` | List your profiles |\n| `ocx config edit --global` | Edit your global config |\n| `ocx migrate` | Dry-run preview of v1.4.6 → v2 migration (shows what would change, no writes) |\n| `ocx migrate --apply` | Apply migration to receipt format |\n| `ocx migrate --global` | Dry-run preview of global root + all profiles migration |\n| `ocx migrate --global --apply` | Apply migration across global root and profiles |\n\n**[Full CLI Reference →](https://ocx.kdco.dev/docs/cli/commands)**\n\n## Advanced Usage\n\n### Components\n\nAdd individual components to projects (copied to `.opencode/`, not `node_modules`):\n\n```bash\n# One-time local setup\nocx init\n\n# Add a registry with a name\nocx registry add https://registry.kdco.dev --name kdco\n\n# Install components using name/component syntax\nocx add kdco/workspace\n```\n\nSee [Components \u0026 Registries](https://ocx.kdco.dev/docs/registries/create) for more.\n\n### Upgrading from v1.4.6\n\nIf you have an existing v1.4.6 project, migrate to the receipt format (`.ocx/receipt.jsonc`):\n\n```bash\nocx migrate          # Dry-run: shows what would be migrated (no files written)\nocx migrate --apply  # Apply migration\nocx verify           # Confirm integrity post-migration\n```\n\nFor global config migration (migrates global root and all profiles):\n\n```bash\nocx migrate --global          # Preview migration across global root + all profiles\nocx migrate --global --apply  # Apply migration to global root and every profile\n```\n\n### Creating Registries\n\nScaffold and deploy your own registry:\n\n```bash\nnpx ocx init --registry my-registry\n```\n\nSee [Creating Registries](https://ocx.kdco.dev/docs/registries/create) for details.\n\n## Philosophy\n\nOCX follows the **ShadCN model**: components are copied into your project (`.opencode/`), not hidden in `node_modules`. You own the code—customize freely.\n\nLike **Cargo**, OCX resolves dependencies and verifies integrity. Every component is SHA-256 verified.\n\n*Your AI agent never runs code you haven't reviewed.*\n\n## Documentation\n\n- **[Profiles](https://ocx.kdco.dev/docs/profiles/overview)** — Deep dive into profile configuration and isolation\n- **[CLI Reference](https://ocx.kdco.dev/docs/cli/commands)** — Complete command documentation\n- **[Creating Registries](https://ocx.kdco.dev/docs/registries/create)** — Build and distribute your own components\n- **[Guides](https://ocx.kdco.dev/docs/guides/index)** — Step-by-step tutorials\n\n## Disclaimer\n\nThis project is not built by the OpenCode team and is not affiliated with [OpenCode](https://github.com/sst/opencode) in any way.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdcokenny%2Focx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdcokenny%2Focx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdcokenny%2Focx/lists"}