Skip to content
This repository was archived by the owner on Nov 5, 2026. It is now read-only.
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "Managed-Apps",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure about the scope for this rebrand, should we rename this as well?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch. The plan is to duplicate the plugins to not break existing customers

"metadata": {
"description": "Microsoft Managed Apps plugin marketplace — wraps the @microsoft/managed-apps-cli (ms) toolchain for coding agents (GitHub Copilot CLI, Claude Code).",
"description": "Copilot Managed Runtime plugin marketplace — wraps the @microsoft/cmr-cli (ms) toolchain for coding agents (GitHub Copilot CLI, Claude Code).",
"version": "0.1.0"
},
"owner": {
Expand All @@ -12,8 +12,8 @@
{
"name": "microsoft-managed-apps",
"source": "./plugins/microsoft-managed-apps",
"description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.",
"version": "2.1.8"
"description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/cmr-cli (ms) toolchain.",
"version": "2.1.10"
}
]
}
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: "🐞 Bug Report"
about: "Report a bug with Microsoft Managed Apps"
about: "Report a bug with Copilot Managed Runtime"
title: "[Bug] <short description>"
labels: bug
---
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,13 @@

Copilot Managed Runtime hosts Microsoft 365 line-of-business applications that automatically inherit organizational governance, security, and compliance controls from the moment they're created.

This repository hosts the official first-party project **templates** and is the home for **public issues**. The tooling itself ships as npm packages under the `@microsoft/managed-apps` scope:
This repository hosts the official first-party project **templates** and is the home for **public issues**. The tooling itself ships as npm packages under the `@microsoft` scope:

| Package | Description |
| --- | --- |
| [`@microsoft/managed-apps`](https://www.npmjs.com/package/@microsoft/managed-apps) | SDK for building apps hosted on Copilot Managed Runtime |
| [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli) | Command-line interface for building and managing apps hosted on Copilot Managed Runtime |
| [`@microsoft/managed-apps-vite-plugin`](https://www.npmjs.com/package/@microsoft/managed-apps-vite-plugin) | Vite plugin for apps hosted on Copilot Managed Runtime |
| [`@microsoft/cmr-apps`](https://www.npmjs.com/package/@microsoft/cmr-apps) | SDK for building apps hosted on Copilot Managed Runtime |
| [`@microsoft/cmr-cli`](https://www.npmjs.com/package/@microsoft/cmr-cli) | Command-line interface for building and managing apps hosted on Copilot Managed Runtime |
| [`@microsoft/cmr-apps-vite-plugin`](https://www.npmjs.com/package/@microsoft/cmr-apps-vite-plugin) | Vite plugin for apps hosted on Copilot Managed Runtime |

## Getting started

Expand Down
6 changes: 3 additions & 3 deletions SUPPORT.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

## How to file issues and get help

Microsoft Managed Apps uses GitHub Issues to track bugs. Please search the existing issues before
Copilot Managed Runtime uses GitHub Issues to track bugs. Please search the existing issues before
filing new issues to avoid duplicates. For new issues, file your bug as a new Issue in this
repository.

For how-to questions and product guidance, see the [Microsoft Managed Apps documentation](https://go.microsoft.com/fwlink/?LinkId=2369054).
For how-to questions and product guidance, see the [Copilot Managed Runtime documentation](https://go.microsoft.com/fwlink/?LinkId=2369054).

## Microsoft Support Policy

Microsoft Managed Apps is currently in **public preview**. Support is limited to the resources
Copilot Managed Runtime is currently in **public preview**. Support is limited to the resources
listed above.
4 changes: 2 additions & 2 deletions github-actions/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Agent guide — github-actions

This directory holds the **`install-ms-cli`**, **`ms-app-pack`**, and
**`ms-app-deploy`** GitHub Actions for building and deploying Microsoft Managed
Apps from CI.
**`ms-app-deploy`** GitHub Actions for building and deploying apps on Copilot Managed Runtime
from CI.

If you're an agent (GitHub Copilot CLI, Claude Code, or any other) helping with
this component, the reusable skills below are plain Markdown runbooks — read the
Expand Down
6 changes: 3 additions & 3 deletions github-actions/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Changelog

All notable changes to the Managed Apps GitHub Actions (under `github-actions/`)
All notable changes to the Copilot Managed Runtime GitHub Actions (under `github-actions/`)
are documented here. This project follows [Semantic Versioning](https://semver.org)
and the format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

Expand All @@ -12,10 +12,10 @@ the new version **in the same PR that bumps the version**, before it merges to

## [1.0.1] - 2026-06-22

Initial release of the Managed Apps GitHub Actions.
Initial release of the Copilot Managed Runtime GitHub Actions.

### Added
- `install-ms-cli` — installs `@microsoft/managed-apps-cli` (binary: `ms`) on the
- `install-ms-cli` — installs `@microsoft/cmr-cli` (binary: `ms`) on the
runner. Supports the public npm registry and private Azure DevOps Artifacts
feeds (`_password`/PAT vs. bearer `_authToken`, chosen by strict hostname match).
- `ms-app-pack` — runs `ms app pack` to build the app and stage the packed artifact.
Expand Down
8 changes: 4 additions & 4 deletions github-actions/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# Managed Apps GitHub Actions
# Copilot Managed Runtime GitHub Actions

GitHub Actions for building and deploying [Microsoft Managed Apps](https://www.npmjs.com/package/@microsoft/managed-apps-cli) from CI.
GitHub Actions for building and deploying apps on [Copilot Managed Runtime](https://www.npmjs.com/package/@microsoft/cmr-cli) from CI.

## Actions

| Action | What it does | Ref |
|---|---|---|
| [`install-ms-cli`](./install-ms-cli) | Installs `@microsoft/managed-apps-cli` (binary: `ms`) on the runner. | `microsoft/Managed-Apps/github-actions/install-ms-cli@v1` |
| [`install-ms-cli`](./install-ms-cli) | Installs `@microsoft/cmr-cli` (binary: `ms`) on the runner. | `microsoft/Managed-Apps/github-actions/install-ms-cli@v1` |
| [`ms-app-pack`](./ms-app-pack) | Runs `ms app pack` — builds and packs the app into a deployable artifact. | `microsoft/Managed-Apps/github-actions/ms-app-pack@v1` |
| [`ms-app-deploy`](./ms-app-deploy) | Runs `ms app deploy` — uploads the artifact and deploys to the target environment. | `microsoft/Managed-Apps/github-actions/ms-app-deploy@v1` |

Expand Down Expand Up @@ -53,7 +53,7 @@ See each action's `action.yml` for the full input/output reference.

Step-by-step guides any operator — or coding-agent CLI (GitHub Copilot CLI, Claude Code, etc.) — can follow. See [`AGENTS.md`](AGENTS.md) for the index.

- [Architecture & Flow](agent-skills/architecture.md) — the end-to-end managed apps lifecycle (setup, local dev, CI loops), the `ms-app-deploy` sequence with service rejection points, and the release/versioning flow, with diagrams.
- [Architecture & Flow](agent-skills/architecture.md) — the end-to-end Copilot Managed Runtime lifecycle (setup, local dev, CI loops), the `ms-app-deploy` sequence with service rejection points, and the release/versioning flow, with diagrams.
- [Release guide](agent-skills/release-guide.md) — how to cut a release PR (version bump + changelog + dist rebuild).

## Prerequisites
Expand Down
10 changes: 5 additions & 5 deletions github-actions/agent-skills/architecture.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# Managed Apps GitHub Actions — Architecture & Flow
# Copilot Managed Runtime GitHub Actions — Architecture & Flow

How the actions under `github-actions/` fit into the end-to-end managed apps lifecycle:
How the actions under `github-actions/` fit into the end-to-end Copilot Managed Runtime lifecycle:
one-time app setup, the local dev loop, the CI/CD deploy loop, and how this repo
releases the actions themselves. Diagrams are Mermaid (render on GitHub).

## Components

| Piece | Role |
|---|---|
| `ms` CLI (`@microsoft/managed-apps-cli`) | Does the real work: scaffolds, builds, packs, uploads, deploys, shares. |
| `ms` CLI (`@microsoft/cmr-cli`) | Does the real work: scaffolds, builds, packs, uploads, deploys, shares. |
| `install-ms-cli` action | Installs the `ms` CLI on the runner. |
| `ms-app-pack` action | Wraps `ms app pack` (build + stage artifact). Optional — deploy can pack internally. |
| `ms-app-deploy` action | Wraps `ms app deploy` (build + pack + upload + deploy). |
Expand Down Expand Up @@ -63,7 +63,7 @@ sequenceDiagram
participant WF as Workflow
participant ACT as ms-app-deploy
participant CLI as ms CLI
participant RP as Managed Apps service
participant RP as Copilot Managed Runtime service

WF->>ACT: with working-directory, app-id, client-secret, tenant-id
ACT->>ACT: require MS_MANAGED_APPS_INSTALLED == true
Expand Down Expand Up @@ -127,7 +127,7 @@ flowchart LR
- **Auth:** interactive sign-in (`ms auth login`) works for local dev. For CI,
supply all three Service Principal inputs (`app-id`, `client-secret`,
`tenant-id`) — the actions set `MS_CLI_USE_SP_AUTH` + `MS_CLI_SP_*`, and the service
accepts the SPN for managed apps operations, so the deploy runs with no developer in
accepts the SPN for Copilot Managed Runtime operations, so the deploy runs with no developer in
the loop.
- **Sharing:** for `repoType: none` apps (no platform-managed repo),
`ms app share <id> --access edit` grants contributor access at the **app scope**
Expand Down
2 changes: 1 addition & 1 deletion github-actions/dist/actions/install-ms-cli/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -19836,7 +19836,7 @@ async function main() {
const version = core.getInput(argName.version, { required: false }) || "latest";
const registryUrl = core.getInput(argName.registryUrl, { required: false }) || "https://registry.npmjs.org";
const registryAuthToken = core.getInput(argName.registryAuthToken, { required: false });
const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || "@microsoft/managed-apps-cli";
const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || "@microsoft/cmr-cli";
if (registryAuthToken) {
core.setSecret(registryAuthToken);
}
Expand Down
14 changes: 7 additions & 7 deletions github-actions/install-ms-cli/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@
#
# install-ms-cli/action.yml
#
# Installs the managed apps `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner.
# Installs the Copilot Managed Runtime `ms` CLI (@microsoft/cmr-cli) on the GitHub Actions runner.
#
# Defaults to the public npm registry — @microsoft/managed-apps-cli is published there
# (since 2026-05-14). No inputs are required for standard usage:
# Defaults to @microsoft/cmr-cli on the public npm registry. Standard usage
# requires the renamed package to be published there:
#
# - uses: microsoft/Managed-Apps/github-actions/install-ms-cli@v1
#
Expand All @@ -20,12 +20,12 @@
# registry-auth-token: ${{ secrets.AZURE_DEVOPS_PAT }}
#
name: 'install-ms-cli'
description: 'Install the Microsoft managed apps CLI (@microsoft/managed-apps-cli, binary: ms)'
description: 'Install the Copilot Managed Runtime CLI (@microsoft/cmr-cli, binary: ms)'

inputs:
version:
description: >
Version of @microsoft/managed-apps-cli to install. Use 'latest' or a specific
Version of @microsoft/cmr-cli to install. Use 'latest' or a specific
semver / dev tag. Defaults to 'latest'.
required: false
default: 'latest'
Expand All @@ -47,10 +47,10 @@ inputs:

npm-package-name:
description: >
npm package to install. Defaults to @microsoft/managed-apps-cli, which provides
npm package to install. Defaults to @microsoft/cmr-cli, which provides
the `ms` binary. Override only for testing alternate builds.
required: false
default: '@microsoft/managed-apps-cli'
default: '@microsoft/cmr-cli'

outputs:
cli-version:
Expand Down
10 changes: 5 additions & 5 deletions github-actions/ms-app-deploy/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
#
# ms-app-deploy/action.yml
#
# Deploys a Microsoft managed apps code app via `ms app deploy`. Three deploy modes are
# Deploys a Copilot Managed Runtime code app via `ms app deploy`. Three deploy modes are
# supported, selected based on inputs and the app's repoType from
# ms.config.json:
#
Expand All @@ -18,7 +18,7 @@
# 3. repoType:'native' / 'github' → `ms app deploy --commit <sha>`
# Server-side build for the commit, then deploy.
#
# Requires @microsoft/managed-apps-cli >= 0.7.0 for `--artifact` support.
# Requires @microsoft/cmr-cli >= 0.7.0 for `--artifact` support.
#
# The action reads `appId`, `environmentId`, and `repoType` from
# ms.config.json (written by `ms app create`).
Expand All @@ -35,7 +35,7 @@
# Service Principal auth:
# The auth inputs (`app-id`, `client-secret`, `tenant-id`) are wired to the
# CLI's SPN env vars (MS_CLI_SP_* + MS_CLI_USE_SP_AUTH). The service
# accepts Service Principal identities for managed apps operations. Provide all three
# accepts Service Principal identities for Copilot Managed Runtime operations. Provide all three
# inputs together to deploy as the SPN with no developer in the loop.
# ---------------------------------------------------------------------------
#
Expand Down Expand Up @@ -74,7 +74,7 @@
# tenant-id: ${{ secrets.PP_SP_TENANT_ID }}
#
name: 'ms-app-deploy'
description: 'Deploy a Microsoft managed apps code app for the given commit'
description: 'Deploy a Copilot Managed Runtime code app for the given commit'

inputs:
# ── App context ───────────────────────────────────────────────────────────
Expand All @@ -98,7 +98,7 @@ inputs:
cloud:
description: >
Cloud instance to target. One of: prod, test, preview,
gccmoderate, dev. The managed apps end-to-end flow is currently supported only
gccmoderate, dev. The Copilot Managed Runtime end-to-end flow is currently supported only
in 'test'. Maps to MS_CLI_CLOUD_INSTANCE.
required: false
default: 'test'
Expand Down
6 changes: 3 additions & 3 deletions github-actions/ms-app-pack/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
#
# ms-app-pack/action.yml
#
# Packs a Microsoft managed apps code app into a deployable artifact by invoking `ms app pack`.
# Packs a Copilot Managed Runtime code app into a deployable artifact by invoking `ms app pack`.
# Pack runs the `buildCommand` from ms.config.json (default `npm run build`)
# and copies the build output to the canonical packed layout at
# <workingDirectory>/.ms/packed/apps/<appId>/client/
#
# After pack, `ms-app-deploy` picks up the artifact automatically.
#
# This action is a transitional step. The managed apps CLI is adding a `--artifact`
# This action is a transitional step. The Copilot Managed Runtime CLI is adding a `--artifact`
# flag to `ms app deploy` that will fold pack into deploy for repoType:'none'
# apps. Once that ships, you can drop the `- uses: ms-app-pack` step from
# your workflow.
Expand Down Expand Up @@ -43,7 +43,7 @@
# tenant-id: ${{ secrets.PP_SP_TENANT_ID }}
#
name: 'ms-app-pack'
description: 'Build and pack a Microsoft managed apps code app into a deployable artifact'
description: 'Build and pack a Copilot Managed Runtime code app into a deployable artifact'

inputs:
working-directory:
Expand Down
4 changes: 2 additions & 2 deletions github-actions/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions github-actions/package.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"name": "@microsoft/managed-apps-github-actions",
"name": "@microsoft/cmr-apps-github-actions",
"version": "1.0.1",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should bump this version, synchronize the lock file and add a changelog entry.

"private": true,
"description": "GitHub Actions for building and deploying Microsoft Managed Apps from CI",
"description": "GitHub Actions for building and deploying apps on Copilot Managed Runtime from CI",
"main": "index.js",
"scripts": {
"clean": "node node_modules/gulp/bin/gulp.js clean",
Expand Down
4 changes: 2 additions & 2 deletions github-actions/src/actions/install-ms-cli/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

// src/actions/install-ms-cli/index.ts
//
// Installs the managed apps `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner
// Installs the Copilot Managed Runtime `ms` CLI (@microsoft/cmr-cli) on the GitHub Actions runner
// via npm. The package's `bin` field maps to the `ms` executable.

import * as core from '@actions/core';
Expand Down Expand Up @@ -40,7 +40,7 @@ export async function main(): Promise<void> {
const version = core.getInput(argName.version, { required: false }) || 'latest';
const registryUrl = core.getInput(argName.registryUrl, { required: false }) || 'https://registry.npmjs.org';
const registryAuthToken = core.getInput(argName.registryAuthToken, { required: false });
const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || '@microsoft/managed-apps-cli';
const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || '@microsoft/cmr-cli';

// Mask the auth token so it never appears in logs
if (registryAuthToken) {
Expand Down
4 changes: 2 additions & 2 deletions github-actions/src/actions/ms-app-deploy/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

// src/actions/ms-app-deploy/index.ts
//
// Deploys a Microsoft managed apps code app via `ms app deploy`. Three modes:
// Deploys a Copilot Managed Runtime code app via `ms app deploy`. Three modes:
//
// 1. repoType:'none' + artifact-path supplied → --artifact <zip>
// Uploads a pre-built zip and deploys it.
Expand All @@ -12,7 +12,7 @@
// 3. repoType:'native'/'github' → --commit <sha>
// Server-side build for the commit, then deploy.
//
// Requires @microsoft/managed-apps-cli >= 0.7.0 for --artifact support.
// Requires @microsoft/cmr-cli >= 0.7.0 for --artifact support.
//
// Reads `appId`, `environmentId`, `repoType` from ms.config.json (written
// by `ms app create`).
Expand Down
2 changes: 1 addition & 1 deletion github-actions/src/actions/ms-app-pack/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

// src/actions/ms-app-pack/index.ts
//
// Packs a Microsoft managed apps code app via `ms app pack`. Pack runs the `buildCommand` from
// Packs a Copilot Managed Runtime code app via `ms app pack`. Pack runs the `buildCommand` from
// ms.config.json (default: `npm run build`) and copies the result into the
// canonical packed layout `<projectRoot>/.ms/packed/apps/<appId>/client/`.
//
Expand Down
6 changes: 3 additions & 3 deletions plugins/microsoft-managed-apps/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
{
"name": "microsoft-managed-apps",
"version": "2.1.8",
"description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.",
"version": "2.1.10",
"description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/cmr-cli (ms) toolchain.",
"author": {
"name": "Microsoft",
"url": "https://github.com/microsoft/Managed-Apps"
},
"homepage": "https://www.npmjs.com/package/@microsoft/managed-apps-cli",
"homepage": "https://www.npmjs.com/package/@microsoft/cmr-cli",
"repository": "https://github.com/microsoft/Managed-Apps",
"license": "MIT",
"keywords": [
Expand Down
6 changes: 3 additions & 3 deletions plugins/microsoft-managed-apps/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Microsoft Managed Apps Plugin — Development Guidelines
# Copilot Managed Runtime Plugin — Development Guidelines

This file provides instructions for assistants working on the managed apps plugin itself (not for end-users of the plugin).
This file provides instructions for assistants working on the Copilot Managed Runtime plugin itself (not for end-users of the plugin).

## Overview

The managed apps plugin wraps `@microsoft/managed-apps-cli` (binary `ms`) to scaffold, develop, and ship managed apps end-to-end. It provides skills for:
The Copilot Managed Runtime plugin wraps `@microsoft/cmr-cli` (binary `ms`) to scaffold, develop, and ship apps on Copilot Managed Runtime end-to-end. It provides skills for:

- Creating a new app (`/create-app`) — global install of the CLI, scaffold, local dev loop.
- Iterating locally (`/dev`) — `ms app dev`, hot reload against the App Player.
Expand Down
Loading
Loading