> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Browsing & Installing

> Search, evaluate, and install packages from the ArgentOS marketplace.

## Searching

<Tabs>
  <Tab title="Via CLI">
    ```bash theme={null}
    # Search by keyword
    argent marketplace search "browser automation"

    # Search by type
    argent marketplace search --type skill "research"

    # Search by author
    argent marketplace search --author argentos
    ```
  </Tab>

  <Tab title="Via Web">
    Browse [marketplace.argentos.ai](https://marketplace.argentos.ai) for a visual catalog with ratings, downloads, and detailed descriptions.
  </Tab>
</Tabs>

## Package Details

Before installing, review the package details:

```bash theme={null}
argent marketplace info @argentos/research
```

This shows:

* Description and version
* Author and license
* Required permissions
* Dependencies
* Download count and rating
* Changelog

## Installing Packages

<Tabs>
  <Tab title="From the Marketplace">
    ```bash theme={null}
    argent marketplace install @argentos/research
    ```

    The CLI:

    1. Downloads the package
    2. Shows required permissions and asks for confirmation
    3. Installs to `~/.argentos/extensions/`
    4. Registers the package with the agent runtime
    5. Restarts affected components if needed
  </Tab>

  <Tab title="From a Local Directory">
    ```bash theme={null}
    argent marketplace install ./my-local-package
    ```
  </Tab>

  <Tab title="From Git">
    ```bash theme={null}
    argent marketplace install https://github.com/user/argent-skill-repo
    ```
  </Tab>
</Tabs>

## Managing Installed Packages

### List

```bash theme={null}
argent marketplace list
```

Shows all installed packages with version, type, and status.

### Update

```bash theme={null}
# Update a specific package
argent marketplace update @argentos/research

# Update all packages
argent marketplace update --all
```

### Uninstall

```bash theme={null}
argent marketplace uninstall @argentos/research
```

## Version Pinning

By default, `install` gets the latest version. Pin to a specific version:

```bash theme={null}
argent marketplace install @argentos/research@1.2.3
```

## Permissions Review

When a package requests permissions, the CLI displays them:

```
@argentos/research requires:
  - exec: Execute shell commands (for web scraping tools)
  - browser: Web browsing automation
  - memory_store: Write to agent memory

Accept? [y/N]
```

<Warning>
  Review permissions carefully before accepting, especially for community packages.
</Warning>

## Offline Installation

For air-gapped environments, download packages on a connected machine and transfer:

```bash theme={null}
# Download without installing
argent marketplace download @argentos/research --output ./packages/

# Install from downloaded file
argent marketplace install ./packages/argentos-research-1.2.3.tgz
```