Skip to main content
Now that Packmind contains coding standards, commands, and skills, let’s distribute them to your Git Repositories. The distribution will commit instructions files that will be used by AI Agents (Claude Code, Cursor, etc.).

​
Supported AI Agents

Packmind supports multiple AI coding assistants. Organization administrators can choose which agents to enable in Settings → Distribution → Rendering. See Manage AI Agent Rendering for details. For a detailed breakdown of where standards, commands, and skills appear for each AI assistant, see Understanding Where Your Artifacts Appear.
Default skills included — All distributions automatically include Packmind’s default skills (such as packmind-update-playbook for creating and updating playbook artifacts with AI assistance). These are added alongside your package contents regardless of which distribution method you use.
Need support for a new AI agent? You can create an issue in our repository to request support for additional AI coding assistants.

​
How to Distribute

There are two ways to distribute packages to your repositories:
  1. Using the Packmind app - Distribute packages through the web interface with full control over targets and repositories
  2. Using packmind-cli - Install packages directly from your terminal, useful for CI/CD pipelines and local development

​
Distribution Methods Overview

​
Distribute via the App

To distribute standards, commands, and skills, you need to add them to a package. A package is a curated collection of commands, standards, and skills grouped together (e.g., “Frontend React Standards”, “Backend API Guidelines”). When you distribute a package:
  • All commands, standards, and skills in the package are distributed together
  • The latest version of each item is used
  • A single commit contains all the package content
  • You can distribute multiple packages at once to the same target
To distribute packages:
  1. Navigate to the Packages section
  2. Select the package(s) you want to distribute
  3. Click Distribute and choose your target repositories
  4. Confirm the Distribution
This approach is useful when you want to:
  • Distribute related guidelines together
  • Maintain consistent sets of standards across projects
  • Organize guidelines by technology, team, or project structure
For more information on creating and managing packages, see Packages Management.

​
Distribute via packmind-cli

You can also distribute packages directly from your terminal using the packmind-cli command:
For example:
When your organization uses multiple Spaces, prefix package slugs with the space slug using @space/package notation.
This will:
  1. Fetch the specified packages from Packmind
  2. Generate the instruction files for all enabled AI agents
  3. Write the files to your local repository
  4. Notify Packmind that a distribution occurred

​
CLI Distribution Considerations

When you distribute packages using the CLI, Packmind automatically creates a Git provider entry to track the distribution. However, these CLI-created providers have some limitations:
Limited Provider Management — Git providers created through CLI distributions are not authenticated. This means you cannot trigger new distributions from the app for these repositories, you cannot add new targets to these providers from the app, and the provider appears in your organization’s Git settings but with limited functionality. To enable full management from the app, connect a Git provider in Settings → Git Providers — using the GitHub App (recommended) or a personal access token. See Git Repository Connection for the full setup.

​
When to Use CLI Distribution

The CLI approach is ideal for:
  • CI/CD pipelines - Automate distribution as part of your deployment process
  • Local development - Quickly install packages without leaving your terminal
  • Monorepos - Use packmind-cli install to install packages for all packmind.json files in the repository
  • Self-hosted Git instances - Distribute to repositories that aren’t connected to the app

​
Distribution History and the Tracked Branch

Every package, standard, command, and skill has a Distribution History listing when it was distributed and where it landed. When your organization tracks a repository and branch (see the Track Command), Packmind shows the branch you currently track. Distributions made on other branches of the same repository are hidden, so the view stays focused on the branch your team works from today. This applies to both places branches surface:
  • Distribution History — entries recorded on another branch of a tracked repository are not listed.
  • The Deployments overview — the repositories list only shows the tracked branch, so a repository never appears twice under two branches.
Repositories you have never tracked are unaffected — every branch keeps showing in both views.

​
Moving the Tracked Branch Is Reversible

Moving tracking to another branch never deletes anything:
  • Distributions recorded on the branch you leave are kept, just no longer displayed.
  • Move tracking back and the earlier history reappears, with new distributions added to it.
So a team that tracks main, moves to dev for a while, then returns to main finds their original main history intact and continuing where it left off.
Only one branch at a time — Packmind shows the tracked branch’s history rather than several branches side by side. To see another branch’s history, ask an organization admin to move tracking to it with packmind-cli track --update.

​
Removing Tracking

An organization admin can take a repository out of the governance views entirely by running packmind-cli untrack from a clone of it (see the Untrack Command). The repository disappears from Distribution History and the Deployments overview. Nothing is deleted. Every distribution recorded before the removal is kept, and tracking the same branch again brings the whole history back, with new distributions appended to it. Tracking a different branch instead starts that branch’s history fresh, while the original branch’s history stays retained and returns whenever you track it again. While a repository is untracked, packmind-cli install behaves exactly as it does for a repository that was never tracked: it completes locally and tells you the distribution was not recorded.

​
Removing Packages

When you no longer need a package in your repository, you can remove it using either the app or the CLI.

​
Remove via the App

In the Packmind app, you can remove packages one-by-one from your distributions:
  1. Navigate to the Packages section
  2. Open the package you want to remove
  3. Click Remove from target and confirm the removal

​
Remove via the CLI

There are two ways to remove packages using the CLI: Option 1: Use the remove command
For example:
Option 2: Edit packmind.json and reinstall
  1. Open your packmind.json file
  2. Remove the package slug from the packages list
  3. Run the install command to update your repository:
This approach is useful when you want to make multiple changes to your package configuration at once.

​
Publishing to a Marketplace

Besides committing instruction files into your repositories, you can publish a package as a managed plugin to a marketplace so your team can install it directly in Claude Code. See Publish to a marketplace for how to link a marketplace, publish packages, and monitor adoption.

​
Retiring a Published Plugin

If a package was published to a marketplace as a managed plugin, you can retire it through a dedicated flow that opens a deletion pull request in the marketplace repository. See Retire a plugin from a marketplace for the step-by-step process.