# gpm info

Display detailed information about a package from the registry.

## Usage

```bash
gpm info <package> [flags]
```

## Arguments

* `<package>` - Package name (e.g., `com.unity.analytics`)

## Flags

| Flag                  | Description                    | Default        |
| --------------------- | ------------------------------ | -------------- |
| `--version <version>` | Show info for specific version | Latest version |
| `--verbose`           | Show detailed information      | `false`        |
| `--json`              | Output results in JSON format  | `false`        |

## Description

The `gpm info` command displays comprehensive information about a package from the registry, including version details, dependencies, distribution information, and metadata.

### Information Displayed

* **Package Metadata**: Name, description, author, license
* **Version Information**: Latest version, available versions
* **Distribution Tags**: Available distribution tags
* **Dependencies**: Package dependencies and versions
* **Registry Details**: Tarball URL, integrity hash
* **Unity Information**: Unity version requirements

## Examples

### Basic Usage

```bash
# Show package information
gpm info com.unity.analytics

# Show specific version
gpm info com.unity.analytics --version 2.1.0

# Show detailed information
gpm info com.unity.analytics --verbose
```

### JSON Output

```bash
# Get package info in JSON format
gpm info com.unity.analytics --json

# Get specific version in JSON
gpm info com.unity.analytics --version 2.1.0 --json
```

## Output Formats

### Human Format (Default)

```
Package Information
─────────────────────────────────────────
Name: com.unity.analytics
Description: Analytics and insights for Unity games
Dist-tags: latest: 2.1.0

Latest Version: 2.1.0
Author: Unity Technologies <support@unity3d.com>
Keywords: unity, analytics, insights
Unity Version: 2021.3

Distribution:
  Tarball: https://cdn.gpm.sh/tarballs/com.unity.analytics/2.1.0.tgz
  Integrity: sha512-rjzUCACnBKOYRtn2Ttv67MRXFDNLsL1FSTgzyp4m6IYGErjRyYFJBO0O9cfjFrB1j79WvCR072HSe4a31ug1tQ==

Dependencies:
  com.unity.services.core@1.10.1
  com.unity.services.analytics@1.0.0

─────────────────────────────────────────
```

### JSON Format (`--json`)

```json
{
  "success": true,
  "package": "com.unity.analytics",
  "version": "2.1.0",
  "description": "Analytics and insights for Unity games",
  "author": "Unity Technologies <support@unity3d.com>",
  "keywords": ["unity", "analytics", "insights"],
  "unity_version": "2021.3",
  "dist_tags": {
    "latest": "2.1.0"
  },
  "distribution": {
    "tarball": "https://cdn.gpm.sh/tarballs/com.unity.analytics/2.1.0.tgz",
    "integrity": "sha512-rjzUCACnBKOYRtn2Ttv67MRXFDNLsL1FSTgzyp4m6IYGErjRyYFJBO0O9cfjFrB1j79WvCR072HSe4a31ug1tQ=="
  },
  "dependencies": {
    "com.unity.services.core": "1.10.1",
    "com.unity.services.analytics": "1.0.0"
  },
  "message": "Package information retrieved successfully"
}
```

## Version Information

### Latest Version

```bash
# Show latest version info
gpm info com.unity.analytics
```

### Specific Version

```bash
# Show specific version info
gpm info com.unity.analytics --version 2.0.0
```

### Version Comparison

```bash
# Compare versions
gpm info com.unity.analytics --version 2.0.0
gpm info com.unity.analytics --version 2.1.0
```

## Distribution Information

### Tarball Details

The info command shows:

* **Tarball URL**: Direct download link
* **Integrity Hash**: SHA512 hash for verification
* **File Size**: Package size information
* **Distribution Tags**: Available tags and versions

### Integrity Verification

```bash
# Get integrity hash
gpm info com.unity.analytics --json | jq '.distribution.integrity'

# Verify package integrity
gpm install com.unity.analytics
```

## Dependencies

### Dependency Information

```bash
# Show dependencies
gpm info com.unity.analytics

# Show dependency tree
gpm list --depth 2
```

### Dependency Versions

The info command shows:

* **Direct Dependencies**: Packages directly required
* **Version Ranges**: Compatible version ranges
* **Optional Dependencies**: Optional package requirements

## Unity-Specific Information

### Unity Version Requirements

```bash
# Show Unity version requirements
gpm info com.unity.analytics --verbose
```

### Unity Package Manager Integration

```bash
# Check UPM compatibility
gpm info com.unity.analytics
```

## Registry-Specific Information

### Global Registry

```bash
# Show info from global registry
gpm info com.unity.analytics --registry https://registry.gpm.sh
```

### Tenant Registry

```bash
# Show info from tenant registry
gpm info com.company.package --registry https://company.gpm.sh
```

## Error Handling

### Common Errors

* **Package not found**: `Package 'com.example.package' not found`
* **Version not found**: `Version '1.0.0' not found for package`
* **Registry error**: `Failed to fetch package information`
* **Network error**: `Failed to connect to registry`

### Troubleshooting

1. **Package not found**: Check package name and registry
2. **Version not found**: Check available versions with `gpm search`
3. **Registry error**: Verify registry URL and network connectivity
4. **Network error**: Check internet connection and proxy settings

## Use Cases

### Package Research

```bash
# Research package before installation
gpm info com.unity.analytics

# Check package compatibility
gpm info com.unity.analytics --version 2.1.0
```

### Dependency Analysis

```bash
# Analyze package dependencies
gpm info com.unity.analytics --verbose

# Check dependency versions
gpm info com.unity.analytics --json | jq '.dependencies'
```

### CI/CD Integration

```bash
# Get package info in CI
gpm info com.unity.analytics --json > package-info.json

# Check package availability
gpm info com.unity.analytics --json | jq '.success'
```

## Best Practices

### Package Selection

```bash
# Always check package info before installation
gpm info com.unity.analytics
gpm install com.unity.analytics

# Verify package integrity
gpm info com.unity.analytics --json | jq '.distribution.integrity'
```

### Version Management

```bash
# Check available versions
gpm info com.unity.analytics

# Check specific version
gpm info com.unity.analytics --version 2.1.0
```

### Registry Management

```bash
# Use appropriate registry
gpm info com.unity.analytics --registry https://registry.gpm.sh
gpm info com.company.package --registry https://company.gpm.sh
```

## Related Commands

* [`gpm search`](/cli-reference/cli/registry/search.md) - Search for packages
* [`gpm install`](/cli-reference/cli/package-management/install.md) - Install packages
* [`gpm list`](/cli-reference/cli/package-management/list.md) - List installed packages

## See Also

* [Registry Operations](/cli-reference/cli/registry.md)
* [Package Management](/cli-reference/cli/package-management.md)
* [Package Guidelines](https://github.com/gpm-sh/docs/blob/main/packages/README.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gpm.sh/cli-reference/cli/registry/info.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.