agentsmesh installs

Read-only namespace for inspecting installed packs. The only subcommand today is list; future read-only subcommands plug in here.

Note

installs (plural) lists what’s already installed. install (singular) adds a pack from a source URL. The dispatcher emits a “did you mean install?” hint when you type an unknown subcommand to soften the typo path.

Usage

agentsmesh installs list [flags]

Subcommands

Subcommand	Description
list	List installed packs (NAME, SOURCE, FEATURES, INSTALLED).

Unknown subcommands exit 2 and print a “did you mean install?” hint.

Flags

Flag	Description
--global	Read from ~/.agentsmesh/installs.yaml.
--json	Machine-readable JSON envelope on stdout.

Examples

List installed packs

agentsmesh installs list

NAME                     SOURCE                                      FEATURES                  INSTALLED
addyosmani-agent-skills  github:addyosmani/agent-skills@5b4c6da       skills, agents, commands  2026-05-16
team-agents              github:my-org/team-agents@v1.0.0             agents                    2026-05-12

Empty list prints No installed packs. and exits 0. Rows preserve the order in installs.yaml (no resort at read time).

Global scope

agentsmesh installs list --global

Reads ~/.agentsmesh/installs.yaml. pack_path is reported relative to ~/.agentsmesh/.

JSON output

agentsmesh installs list --json

{
  "success": true,
  "command": "installs",
  "data": {
    "scope": "project",
    "subcommand": "list",
    "installs": [
      {
        "name": "addyosmani-agent-skills",
        "source": "github:addyosmani/agent-skills@5b4c6da",
        "source_kind": "github",
        "source_type": "anthropic-skill-pack",
        "version": "5b4c6da",
        "features": ["skills", "agents", "commands"],
        "target": null,
        "installed_at": "2026-05-16T10:00:00.000Z",
        "pack_path": ".agentsmesh/packs/addyosmani-agent-skills"
      },
      {
        "name": "legacy-rules",
        "source": "local:./vendor/legacy-rules",
        "source_kind": "local",
        "source_type": null,
        "version": null,
        "features": ["rules"],
        "target": null,
        "installed_at": null,
        "pack_path": ".agentsmesh/packs/legacy-rules"
      }
    ]
  }
}

source_type and installed_at are hydrated from each pack’s .agentsmesh-install-manifest.json; both are null when the manifest is missing (legacy packs installed before per-file integrity tracking, or packs whose manifest was manually deleted). version is null for local-path or unpinned remote sources. target is null unless the install used --target <id>. Forward-slash pack_path per the project CLI display rule.

What’s not covered

installs show <name>, installs prune, and installs verify are explicitly out of scope until real use cases surface. To remove a pack, use agentsmesh uninstall. To re-install missing packs after a fresh clone, use agentsmesh install --sync.