{"id":98908,"date":"2026-09-17T14:08:50","date_gmt":"2026-09-17T21:08:50","guid":{"rendered":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api"},"modified":"2026-09-17T14:50:56","modified_gmt":"2026-09-17T21:50:56","slug":"agentic-cli-customizations-now-in-the-usage-metrics-api","status":"publish","type":[3522],"link":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api","title":{"rendered":"Agentic CLI customizations now in the usage metrics API"},"content":{"rendered":"<!DOCTYPE html PUBLIC \"-\/\/W3C\/\/DTD HTML 4.0 Transitional\/\/EN\" \"http:\/\/www.w3.org\/TR\/REC-html40\/loose.dtd\">\n<html><body><p>GitHub Copilot expands existing CLI report coverage with agentic activity metrics for skills, custom agents, Model Context Protocol (MCP) servers, slash commands, and plugins.<\/p>\n<h3 id=\"whats-new\" id=\"whats-new\" ><a class=\"heading-link\" href=\"#whats-new\">What&rsquo;s new<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<p>The fields appear in enterprise and organization per-user and aggregate 1-day reports, per-user 28-day reports, and the <code>day_totals<\/code> entries in aggregate 28-day reports.<\/p>\n<p>In a per-user report, the fields answer two questions about that user&rsquo;s activity. In an aggregate report, they answer the same questions across the enterprise or organization:<\/p>\n<ul>\n<li><strong>Which items are used most?<\/strong> The <code>totals_by_skill<\/code>, <code>totals_by_custom_agent<\/code>, <code>totals_by_mcp<\/code>, <code>totals_by_slash_cmd<\/code>, and <code>totals_by_plugin<\/code> arrays list up to five items with the most recorded activity. Each entry includes an <code>interaction_count<\/code>. Depending on the category, this counts invocations for skills, slash commands, and plugin skills, plus custom agent starts and MCP server connection attempts.<\/li>\n<li><strong>How many different items were used?<\/strong> The <code>distinct_skill_use_count<\/code>, <code>distinct_custom_agent_use_count<\/code>, <code>distinct_mcp_use_count<\/code>, <code>distinct_slash_cmd_use_count<\/code>, and <code>distinct_plugin_use_count<\/code> fields count the number of different items used. In a per-user report, each item that user used counts once. In an aggregate report, each item used by anyone in the enterprise or organization counts once, not once per user. These counts include items outside the top five, and comparing them over time shows whether the variety of items in use is growing.<\/li>\n<\/ul>\n<h3 id=\"why-this-matters\" id=\"why-this-matters\" ><a class=\"heading-link\" href=\"#why-this-matters\">Why this matters<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<p>Enterprise and organization administrators are now able to identify which Copilot CLI customizations are gaining traction, find enablement gaps, and focus investment on automations that developers find valuable.<\/p>\n<h3 id=\"important-notes\" id=\"important-notes\" ><a class=\"heading-link\" href=\"#important-notes\">Important notes<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<ul>\n<li>Names for recognized GitHub-provided items are shown. To protect privacy, customer-defined names are not shown. Skills, custom agents, MCP servers, and plugins are grouped under <code>other<\/code>. Copilot CLI telemetry already groups customer-defined slash commands under <code>custom<\/code>, so reports use that label for slash commands.<\/li>\n<li>For MCP servers, <code>interaction_count<\/code> increases only when Copilot CLI attempts to connect or reconnect to the server. Successful and failed attempts both count. Calling tools from the same connected server multiple times does not increase the count.<\/li>\n<li>Plugin metrics count only skill invocations associated with a plugin. Every plugin interaction therefore also appears in the skill totals, but skill interactions that do not come from a plugin appear only in the skill totals. Because the plugin totals are a subset of the skill totals, you should not add the two together.<\/li>\n<li>Empty arrays and zero counts indicate no matching activity. The fields are null or absent when customization data is unavailable.<\/li>\n<li>Reports are available to enterprise owners and billing managers, organization owners, and anyone with a custom organization or enterprise role that grants the <code>View Copilot Metrics<\/code> permission. The Copilot usage metrics policy must be enabled.<\/li>\n<\/ul>\n<p>Visit the <a href=\"https:\/\/docs.github.com\/enterprise-cloud@latest\/rest\/copilot\/copilot-usage-metrics\">Copilot usage metrics API documentation<\/a> to get started.<\/p>\n<\/body><\/html>\n","protected":false},"excerpt":{"rendered":"<p>GitHub Copilot expands existing CLI report coverage with agentic activity metrics for skills, custom agents, Model Context Protocol (MCP) servers, slash commands, and plugins. What&rsquo;s new The fields appear in&hellip;<\/p>\n","protected":false},"author":2106,"featured_media":0,"template":"","meta":{"_gh_post_show_toc":"","_gh_post_is_no_robots":"","_gh_post_is_featured":"","_gh_post_is_excluded":"","_gh_post_is_unlisted":"","_gh_post_related_link_1":"","_gh_post_related_link_2":"","_gh_post_related_link_3":"","_gh_post_sq_img":"","_gh_post_sq_img_id":"","_gh_post_cta_title":"","_gh_post_cta_text":"","_gh_post_cta_link":"","_gh_post_cta_button":"","_gh_post_recirc_hide":"","_gh_post_recirc_col_1":"","_gh_post_recirc_col_2":"","_gh_post_recirc_col_3":"","_gh_post_recirc_col_4":"","_featured_video":"","_gh_post_additional_query_params":"","footnotes":"","_links_to":"","_links_to_target":"","primary_cta":"","primary_cta_url":"","secondary_cta":"","secondary_cta_url":""},"label":[3633,2765,3632],"group":[3918],"coauthors":[3100],"class_list":["post-98908","changelog","type-changelog","status-publish","hentry","changelog-type-improvements","changelog-label-account-management","changelog-label-copilot","changelog-label-enterprise-management-tools","changelog-group-09-2026"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v28.4 (Yoast SEO v28.4) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Agentic CLI customizations now in the usage metrics API - GitHub Changelog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Agentic CLI customizations now in the usage metrics API \u00b7 GitHub Changelog\" \/>\n<meta property=\"og:description\" content=\"GitHub Copilot expands existing CLI report coverage with agentic activity metrics for skills, custom agents, Model Context Protocol (MCP) servers, slash commands, and plugins. What&rsquo;s new The fields appear in&hellip;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/\" \/>\n<meta property=\"og:site_name\" content=\"The GitHub Blog\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-17T21:50:56+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/github.blog\/wp-content\/uploads\/2026\/09\/651495740-3ffb3913-62c3-4737-bf5c-7c146f942d00.jpeg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"Allison\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\\\/\",\"url\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\\\/\",\"name\":\"Agentic CLI customizations now in the usage metrics API - The GitHub Blog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/github.blog\\\/#website\"},\"datePublished\":\"2026-09-17T21:08:50+00:00\",\"dateModified\":\"2026-09-17T21:50:56+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/github.blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Changelogs\",\"item\":\"https:\\\/\\\/github.blog\\\/changelog\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Agentic CLI customizations now in the usage metrics API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/github.blog\\\/#website\",\"url\":\"https:\\\/\\\/github.blog\\\/\",\"name\":\"The GitHub Blog\",\"description\":\"Updates, ideas, and inspiration from GitHub to help developers build and design software.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/github.blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Agentic CLI customizations now in the usage metrics API - GitHub Changelog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/","og_locale":"en_US","og_type":"article","og_title":"Agentic CLI customizations now in the usage metrics API \u00b7 GitHub Changelog","og_description":"GitHub Copilot expands existing CLI report coverage with agentic activity metrics for skills, custom agents, Model Context Protocol (MCP) servers, slash commands, and plugins. What&rsquo;s new The fields appear in&hellip;","og_url":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/","og_site_name":"The GitHub Blog","article_modified_time":"2026-09-17T21:50:56+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/github.blog\/wp-content\/uploads\/2026\/09\/651495740-3ffb3913-62c3-4737-bf5c-7c146f942d00.jpeg","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes","Written by":"Allison"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/","url":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/","name":"Agentic CLI customizations now in the usage metrics API - The GitHub Blog","isPartOf":{"@id":"https:\/\/github.blog\/#website"},"datePublished":"2026-09-17T21:08:50+00:00","dateModified":"2026-09-17T21:50:56+00:00","breadcrumb":{"@id":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/github.blog\/changelog\/2026-09-17-agentic-cli-customizations-now-in-the-usage-metrics-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/github.blog\/"},{"@type":"ListItem","position":2,"name":"Changelogs","item":"https:\/\/github.blog\/changelog\/"},{"@type":"ListItem","position":3,"name":"Agentic CLI customizations now in the usage metrics API"}]},{"@type":"WebSite","@id":"https:\/\/github.blog\/#website","url":"https:\/\/github.blog\/","name":"The GitHub Blog","description":"Updates, ideas, and inspiration from GitHub to help developers build and design software.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/github.blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/98908","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs"}],"about":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/types\/changelog"}],"author":[{"embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/users\/2106"}],"version-history":[{"count":2,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/98908\/revisions"}],"predecessor-version":[{"id":98914,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/98908\/revisions\/98914"}],"wp:attachment":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/media?parent=98908"}],"wp:term":[{"taxonomy":"changelog-type","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/type?post=98908"},{"taxonomy":"changelog-label","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/label?post=98908"},{"taxonomy":"changelog-group","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/group?post=98908"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/coauthors?post=98908"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}