openpitrix
KubeSphere OpenPitrix application management Skill. Use when users ask about KubeSphere App Store, OpenPitrix, Helm/YAML application templates, application repositories, app versions, app releases, categories, review states, repository sync, or troubleshooting application installation and upgrade issues.
npx skills add kubesphere/kubesphere --skill openpitrix --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
Guides an AI agent to manage OpenPitrix/KubeSphere application assets: repositories, app templates, versions, releases, categories, reviews, and syncing. Emphasizes using v2 API objects first (Application, ApplicationVersion, ApplicationRelease, Category, Repo) and maps them to corresponding Helm/YAML templates, app stores, and installation workflows. Provides example routes and actions for creating/updating repos, listing apps/versions/releases, reviewing/publishing versions, and creating releases with required metadata and labels.
How it works
Outlines the OpenPitrix architecture and the controller responsibilities:
- Use v2 objects first: Application, ApplicationVersion, ApplicationRelease, Category, Repo.
- Repo sync, app templates, and app store listings are managed via Repo, Application, and ApplicationVersion objects.
- App releases are created in namespaces with required spec fields (appID, appVersionID, appType, and values) and labels for workspace/cluster/namespace.
- Provides concrete API routes for Kubernetes-style CRUD and actions (POST/GET/PATCH/DELETE) under /kapis/application.kubesphere.io/v2 and older /kapis/openpitrix.io/v2alpha1 if needed.
- Recommends tool usage: kubectl for cluster resources, ks_api.py for JSON KAPIs, curl for multipart or custom headers.
When to use it
Use when users ask about KubeSphere App Store, OpenPitrix, Helm/YAML app templates, app repositories, app versions, app releases, categories, review states, repository sync, or troubleshooting installation and upgrade issues.
What it can touch
- Repositories: creates, updates, deletes, and triggers manual sync via Repo routes.
- Apps: lists, describes, creates/updates metadata, and handles app actions.
- Versions: lists, creates, describes, lists files, and actions to publish reviews.
- Releases: creates, describes, lists by workspace/namespace, and deletes; requires specific metadata and labels in the request.
- Categories and reviews: lists and manages via dedicated endpoints.
Caveats
- Early/OpenPitrix integration uses v2 APIs; older v2alpha1 endpoints exist as read/list wrappers.
- Do not invent fields in release specs; follow documented spec structure and required labels.
- Ensure proper authentication via ks_api.py or curl with a Bearer token.
- Namespaces and workspaces are important for routing and labels; follow the guidance on where to post releases.
# OpenPitrix Application Management ## Overview OpenPitrix is KubeSphere's application management capability for app repositories, app templates, versions, reviews, and app releases. In KubeSphere 4.x the runtime API group is `application.kubesphere.io/v2`; older OpenPitrix extension code used `openpitrix.io/v2` CRUD APIs and `openpitrix.io/v2alpha1` read/list wrappers over `application.kubesphere.io/v1alpha1` resources. Use the v2 objects and APIs first: | Concept | KubeSphere 4.x object | Older OpenPitrix object | |---|---|---| | Repository | `Repo` | `HelmRepo` | | App template | `Application` | `HelmApplication` | | App template version | `ApplicationVersion` | `HelmApplicationVersion` | | App release / installed app | `ApplicationRelease` | `HelmRelease` | | Category | `Category` | `HelmCategory` | Core namespace and labels: | Item | Value | |---|---| | Application data namespace | `extension-openpitrix` | | Repository label | `application.kubesphere.io/repo-name` | | App label | `application.kubesphere.io/app-id` | | App version label | `application.kubesphere.io/appversion-id` | | App type label | `application.kubesphere.io/app-type` | | Cluster label | `kubesphere.io/cluste
- Overview
- Architecture
- Navigation and Feature Coverage
- Tool Selection
- Quick Inspection
- KAPI Routes
- KSE Application API examples
- Legacy OpenPitrix API examples
- App Store and Workspace App Management Workflow
- Repository Workflow
- Uploaded App Workflow
- Release Workflow
- Categories
- Development Notes
cd skills/kubesphere-core/scripts
export KUBESPHERE_HOST="http://<kubesphere-host>"
python ks_api.py --login --username admin --password <password>
export TOKEN=$(python -c 'import json, os; print(json.load(open(os.path.expanduser("~/.kubesphere_token")))["token"])')
export TOKEN=$(curl -sS -X POST "$KUBESPHERE_HOST/oauth/token" \
kubectl get repos.application.kubesphere.io
kubectl get applications.application.kubesphere.io
kubectl get applicationversions.application.kubesphere.io
kubectl get applicationreleases.application.kubesphere.io
kubectl get categories.application.kubesphere.ioWhat does the openpitrix skill do?
KubeSphere OpenPitrix application management Skill. Use when users ask about KubeSphere App Store, OpenPitrix, Helm/YAML application templates, application repositories, app versions, app releases, categories, review states, repository sync, or troubleshooting application installation and upgrade issues.
How do I install it?
Run `npx skills add kubesphere/kubesphere --skill openpitrix --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From kubesphere/kubesphere, a repository with 17,016 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.