Create your first package
Before distributing your artifacts, organize them into Packages. A package is a curated collection of commands, standards, and skills grouped together—for example, “Frontend Guidelines” or “Backend API Standards”. Packages make it easy to distribute related guidelines as a single unit. To create a package:- Navigate to Packages in the Packmind UI
- Click Create Package
- Provide a name and description
- Select commands, standards, and skills to include
- Save the package
Install packages with CLI
Use the Packmind CLI to install packages locally: List available packages:install for the first time, it creates a packmind.json file in the current directory that tracks which packages are installed. Subsequent runs of packmind install (without arguments) will automatically install all packages listed in this file.
Example - Update from packmind.json:
packmind.json file.
For detailed CLI usage, see the CLI documentation.
Understanding packmind.json
Thepackmind.json file is automatically created in your directory when you first run packmind install with package names. This file tracks which packages are installed locally, making it easy to keep your standards and commands up to date.
File Structure
The file has a simple JSON structure:"*" which means “latest version”.
How It Works
First Installation: When you runpackmind install <package-slug> for the first time, the CLI:
- Downloads the specified packages
- Creates a
packmind.jsonfile in the current directory - Adds the installed packages to the file
packmind install (without package names), the CLI:
- Reads the
packmind.jsonfile - Installs all packages listed in the file
- Updates your local standards and commands to the latest versions
packmind.json configuration.
Managing packmind.json Manually
You can edit thepackmind.json file directly to add or remove packages.
To add a package manually:
- Open
packmind.json - Add the package slug to the
packagesobject:
- Run
packmind installto download the new package
uninstall command (aliased as remove) with one or more package slugs:
packmind.json and deletes the files that were generated for them.
To remove a package manually:
- Open
packmind.json - Remove the package slug from the
packagesobject - Run
packmind installto update your local files
Removal is driven by the
packmind-lock.json lock file, which records every
file Packmind generated during installation. Because the lock file tracks
files for all coding assistants, cleanup is agent-agnostic: it covers every
agent’s artifacts — CLAUDE.md, AGENTS.md, GitHub Copilot
(.github/copilot-instructions.md), Cursor (.cursor/rules/), and others —
so you no longer need to delete leftover files by hand.Using Multiple packmind.json Files
You can runpackmind install in different directories within your project, and each directory will have its own packmind.json file with its own set of packages.
This is useful for:
- Monorepos: Different packages or applications can have different standards
- Layered architectures: Frontend and backend directories can have separate guidelines
- Team boundaries: Different teams working in different directories can maintain their own standards
packmind.json file operates independently. By default, running packmind install (without package names) walks the entire directory tree starting from where you run it, updating every packmind.json it finds in that directory and its sub-directories. To limit the scope to a specific directory (and its direct sub-directories only), pass the --path (-p) option:
Alternative: Install globally for Claude Code
If you use Claude Code and want a package available across every project on your machine — not just one repository — you can runpackmind install inside your ~/.claude directory. The CLI detects this and switches to a home-install mode that renders artifacts directly into ~/.claude/{skills,rules,commands}/..., skips the agent prompt, and avoids creating a .packmind/ mirror in your home folder.
See Install Globally for Claude Code for the full benefits and behavior.
Alternative: Distribute to Git repositories
Instead of pulling locally, you can distribute packages directly to your Git repositories. This pushes standards and commands as files that are committed to your codebase. To learn about distributing to Git repositories, see the Distribution documentation.Use your artifacts
When you prompt your coding assistant, Standards and Commands are automatically included in its context. For complex tasks, the context can grow large, and the generated code may stop following your standards and commands. If this happens, re-add the.packmind directory to the agent’s context and try again.