feat: migrate Apps CLI plugin to cli-plugins monorepo and add related…

.github/config/release.json

@@ -9,6 +9,7 @@
     "migration": false,
     "seed": false,
     "bootstrap": false,
-    "branches": false
+    "branches": false,
+    "apps-cli": false
   }
 }

.github/workflows/release-v2-beta-plugins.yml

@@ -142,3 +142,11 @@ jobs:
           token: ${{ secrets.NPM_TOKEN }}
           package: ./packages/contentstack-query-export/package.json
           tag: beta
+
+      # Apps CLI
+      - name: Publishing apps-cli (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-apps-cli/package.json
+          tag: beta

.github/workflows/unit-test.yml

@@ -66,3 +66,7 @@ jobs:
       - name: Run tests for Contentstack Query Export
         working-directory: ./packages/contentstack-query-export
         run: npm run test:unit
+
+      - name: Run tests for Contentstack Apps CLI
+        working-directory: ./packages/contentstack-apps-cli
+        run: npm run test:unit:report:json

.talismanrc

@@ -1,4 +1,6 @@
 fileignoreconfig:
   - filename: pnpm-lock.yaml
     checksum: e5b5f8ab64f4f27a1483e426cc01d7388482263e1d6fe3baf1caafcf2878ebb2
+  - filename: skills/framework/SKILL.md
+    checksum: c5746de64b1e7d1df051c4337de5eb32de6a4c85c7297aa408838d304bb2d771
 version: '1.0'

AGENTS.md

@@ -7,7 +7,7 @@
 | Field | Detail |
 | --- | --- |
 | **Name:** | Contentstack CLI plugins (pnpm monorepo; root package name `csdx`) |
-| **Purpose:** | OCLIF plugins that extend the Contentstack CLI (import/export, clone, migration, seed, audit, variants, etc.). |
+| **Purpose:** | OCLIF plugins that extend the Contentstack CLI (import/export, clone, migration, seed, audit, variants, Developer Hub apps, etc.). |
 | **Out of scope (if any):** | The **core** CLI aggregation lives in the separate `cli` monorepo; this repo ships plugin packages only. |
 
 ## Tech stack (at a glance)
@@ -35,11 +35,19 @@ CI: [.github/workflows/unit-test.yml](.github/workflows/unit-test.yml) and other
 | Skill | Path | What it covers |
 | --- | --- | --- |
 | Development workflow | [skills/dev-workflow/SKILL.md](skills/dev-workflow/SKILL.md) | pnpm commands, CI, TDD expectations, PR checklist |
-| Contentstack CLI | [skills/contentstack-cli/SKILL.md](skills/contentstack-cli/SKILL.md) | Plugin commands, OCLIF, Contentstack APIs |
-| Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Utilities, config, logging, errors |
+| Contentstack CLI | [skills/contentstack-cli/SKILL.md](skills/contentstack-cli/SKILL.md) | Plugin commands, OCLIF, Contentstack APIs (incl. `app:*` / `@contentstack/apps-cli`) |
+| Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Utilities, config, logging, errors (incl. Developer Hub SDK, manifests, GraphQL) |
 | Testing | [skills/testing/SKILL.md](skills/testing/SKILL.md) | Mocha/Chai, coverage, mocks |
 | Code review | [skills/code-review/SKILL.md](skills/code-review/SKILL.md) | PR review for this monorepo |
 
+## Apps CLI plugin (`@contentstack/apps-cli`)
+
+- **Package path:** [packages/contentstack-apps-cli](packages/contentstack-apps-cli)
+- **npm name:** `@contentstack/apps-cli` (unchanged for consumers)
+- **Migrated from:** [contentstack/contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) — see [APPS-CLI-MIGRATION.md](APPS-CLI-MIGRATION.md)
+- **v1 / v2:** Maintain on `v1-dev` (1.x CLI deps) and `v2-dev` / `v2-beta` (2.x beta deps) branches; align `@contentstack/cli-command` and `@contentstack/cli-utilities` versions with the target CLI line.
+- **Docs:** OCLIF / `app:*` commands → [contentstack-cli](skills/contentstack-cli/SKILL.md#apps-cli-commands-app); SDK, manifests, GraphQL, HTTP → [framework](skills/framework/SKILL.md#apps-cli-plugin-contentstackapps-cli)
+
 ## Using Cursor (optional)
 
 If you use **Cursor**, [.cursor/rules/README.md](.cursor/rules/README.md) only points to **`AGENTS.md`**—same docs as everyone else.

APPS-CLI-MIGRATION.md

@@ -0,0 +1,51 @@
+# Apps CLI migration: standalone repo → cli-plugins monorepo
+
+## Summary
+
+The **@contentstack/apps-cli** plugin (`contentstack-apps-cli`) has moved from the standalone repository [contentstack/contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) into the [contentstack/cli-plugins](https://github.com/contentstack/cli-plugins) monorepo at **`packages/contentstack-apps-cli`**.
+
+The **npm package name is unchanged**: `@contentstack/apps-cli`. Install and command usage stay the same.
+
+## Repository and issue tracking
+
+| Before | After |
+| --- | --- |
+| Source: `github.com/contentstack/contentstack-apps-cli` | Source: `github.com/contentstack/cli-plugins` → `packages/contentstack-apps-cli` |
+| Issues: contentstack-apps-cli repo | Issues: [cli-plugins issues](https://github.com/contentstack/cli-plugins/issues) (label or mention `apps-cli` / `@contentstack/apps-cli`) |
+
+The standalone **contentstack-apps-cli** repository is **archived** after the first release from cli-plugins. Open PRs and bugs should be recreated or linked in cli-plugins.
+
+## Version lines (1.x vs 2.x)
+
+| CLI line | cli-plugins branch | Apps plugin notes |
+| --- | --- | --- |
+| **1.x** | `v1-dev` / `v1-beta` | `@contentstack/cli-command` and `@contentstack/cli-utilities` on 1.x-compatible ranges |
+| **2.x beta** | `v2-dev` / `v2-beta` | Align with 2.x beta core packages (same pattern as export, import, bootstrap) |
+
+Develop and release each line on its branch; do not mix 1.x and 2.x dependency pins in the same branch.
+
+## Install (unchanged)
+
+```bash
+csdx plugins:install @contentstack/apps-cli
+# or
+npm install -g @contentstack/apps-cli
+```
+
+## Local development
+
+Clone [cli-dev-workspace](https://github.com/contentstack/cli-dev-workspace) (or cli-plugins only), then:
+
+```bash
+cd cli-plugins
+pnpm install
+pnpm --filter @contentstack/apps-cli run build
+pnpm --filter @contentstack/apps-cli test
+```
+
+See [AGENTS.md](./AGENTS.md), [skills/contentstack-cli/SKILL.md](./skills/contentstack-cli/SKILL.md#apps-cli-commands-app), and [skills/framework/SKILL.md](./skills/framework/SKILL.md#apps-cli-plugin-contentstackapps-cli) for contributor docs.
+
+## Related migrations
+
+- Core CLI: [cli](https://github.com/contentstack/cli) monorepo
+- Other external plugins (bulk operations, migrate-rte): same cli-plugins consolidation effort

MIGRATION.md

@@ -180,6 +180,14 @@ csdx cm:migrate-rte --help
 
 **Migration Action:** Refer to the detailed [Bulk Operations Migration Guide](./BULK-OPERATIONS-MIGRATION.md) for complete command mappings and examples.
 
+### 7. 📱 Apps CLI plugin repository move
+
+**What Changed:**
+- The Apps CLI plugin (`@contentstack/apps-cli`) source moved from the standalone [contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) repository into this **cli-plugins** monorepo at `packages/contentstack-apps-cli`
+- The npm package name and `csdx app:*` commands are unchanged
+
+**Migration Action:** For repository location, branching (1.x vs 2.x), and issue tracking, see the [Apps CLI Migration Guide](./APPS-CLI-MIGRATION.md).
+
 **Quick Example:**
 ```bash
 # Before (1.x.x)

README.md

@@ -15,6 +15,7 @@ CLI supports content management scripts through which you can perform the follow
 - Migrate HTML RTE to JSON RTE content
 - Change Master Locale
 - Use Bootstrap plugin
+- Manage Developer Hub apps (`app:*` via `@contentstack/apps-cli`)
 - Use Tsgen plugin
 
 

packages/contentstack-apps-cli/.eslintignore

@@ -0,0 +1 @@
+/dist

packages/contentstack-apps-cli/.eslintrc

@@ -0,0 +1,42 @@
+{
+  "env": {
+      "node": true
+  },
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+      "project": "tsconfig.json",
+      "sourceType": "module"
+  },
+  "plugins": [
+      "@typescript-eslint"
+  ],
+  "extends": [
+      "plugin:@typescript-eslint/recommended"
+  ],
+  "ignorePatterns": [
+      "lib/**/*",
+      "test/**/*"
+  ],
+  "rules": {
+      "@typescript-eslint/no-unused-vars": [
+          "error",
+          {
+              "args": "none"
+          }
+      ],
+      "@typescript-eslint/prefer-namespace-keyword": "error",
+      "quotes": "off",
+      "semi": "off",
+      "@typescript-eslint/no-redeclare": "off",
+      "eqeqeq": [
+          "error",
+          "smart"
+      ],
+      "id-match": "error",
+      "no-eval": "error",
+      "no-var": "error",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-require-imports": "off",
+      "prefer-const": "error"
+  }
+}

packages/contentstack-apps-cli/.gitignore

@@ -0,0 +1,21 @@
+*-debug.log
+*-error.log
+/.nyc_output
+/dist
+/lib
+/package-lock.json
+/tmp
+/yarn.lock
+node_modules
+oclif.manifest.json
+.env
+*.log
+tsconfig.tsbuildinfo
+dependabot.yml
+.vscode
+*.todo
+/bkp
+.editorconfig
+oclif.manifest.json
+*.env
+.vscode/

packages/contentstack-apps-cli/.mocharc.json

@@ -0,0 +1,12 @@
+{
+  "require": [
+    "test/helpers/init.js",
+    "ts-node/register"
+  ],
+  "watch-extensions": [
+    "ts"
+  ],
+  "recursive": true,
+  "reporter": "spec",
+  "timeout": 60000
+}

packages/contentstack-apps-cli/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Contentstack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.