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

# CLI

> Interact with Qontext via the command line

## Overview

The [Qontext CLI](https://github.com/qontext-ai/cli) (`qontext`) brings your context repository to the command line.

Today it installs and maintains workspace [Skills](/features/skills) on your local machine: install a skill once, then keep it in sync with a single command. Skills follow the open [Agent Skills specification](https://agentskills.io/specification), so they work with any compatible AI tool.

***

## Install

<Tabs>
  <Tab title="Linux / macOS">
    ```sh theme={null}
    curl -fsSL https://cli.qontext.ai | sh
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    irm https://raw.githubusercontent.com/qontext-ai/cli/main/install.ps1 | iex
    ```
  </Tab>
</Tabs>

<Accordion title="Install manually">
  If you'd rather not pipe a script into a shell:

  1. Download the archive for your platform from the [Releases](https://github.com/qontext-ai/cli/releases) page.
  2. Verify it against `SHA256SUMS-<version>.txt` from the same release:
     * macOS / Linux: `shasum -a 256 -c SHA256SUMS-<version>.txt`
     * Windows: `Get-FileHash -Algorithm SHA256 <archive>`
  3. Extract and move `qontext` (or `qontext.exe`) onto your `PATH`.
</Accordion>

***

## Authentication

Log in to connect the CLI to your workspace and approve the access request:

```bash theme={null}
qontext login
```

<img src="https://mintcdn.com/qontext/j_mvy1O5QjlwxH-k/features/images/skills/cli_auth.png?fit=max&auto=format&n=j_mvy1O5QjlwxH-k&q=85&s=9884ea5318b119903700142620de5860" alt="Qontext CLI authentication" title="Qontext CLI authentication" style={{ width:"91%" }} width="1262" height="686" data-path="features/images/skills/cli_auth.png" />

***

## Managing skills

<Steps>
  <Step title="Install a skill">
    Pass a skill's link to the CLI:

    ```bash theme={null}
    qontext skills add <link>
    ```

    To get the link, open the **Context** tab in the [Qontext app](https://app.qontext.ai), select a skill, and click **Install skill**. Copy either the full install command or the short link.

    <img src="https://mintcdn.com/qontext/j_mvy1O5QjlwxH-k/features/images/skills/install_skill.png?fit=max&auto=format&n=j_mvy1O5QjlwxH-k&q=85&s=715d149824c896c56b0170e8f7a1b3a0" alt="Install skill button with copy install command and copy short link options" title="Install a skill" style={{ width:"91%" }} width="1477" height="1242" data-path="features/images/skills/install_skill.png" />
  </Step>

  <Step title="Keep skills up to date">
    Pull the latest version of every installed skill:

    ```bash theme={null}
    qontext skills sync
    ```
  </Step>
</Steps>

Please refer to [Skills](/features/skills) for how skills are created, imported, and distributed across a workspace.

***

## Updating the CLI

Keep the CLI current with a single command:

```bash theme={null}
qontext update
```

This replaces the installed binary in place with the latest release. The CLI also checks for updates in the background and warns you once a day when a newer version is available.

***

## Command reference

| Command                     | Description                                          |
| --------------------------- | ---------------------------------------------------- |
| `qontext login`             | Authenticate the CLI with your workspace.            |
| `qontext skills add <link>` | Install a skill from your context repository.        |
| `qontext skills sync`       | Update all installed skills to their latest version. |
| `qontext update`            | Update the CLI in place to the latest release.       |

***

## FAQ

<AccordionGroup>
  <Accordion title="Which clients can I install skills into?">
    Any tool that supports the open [Agent Skills specification](https://agentskills.io/specification), such as Claude Code. The CLI places skills in the client's local skills folder.
  </Accordion>

  <Accordion title="How do I update a skill after it changes in Qontext?">
    Run `qontext skills sync`. Skills stay centrally managed in your workspace, so every installed copy updates from a single source of truth.
  </Accordion>
</AccordionGroup>