Skip to content
Cosine

Install & Authenticate

Install the CLI

Section titled “Install the CLI”

The CLI is distributed via multiple channels: Homebrew (recommended for macOS and Linux), direct download, and Windows package managers.

macOS

Section titled “macOS”
Section titled “Homebrew (Recommended)”
Terminal window
brew install CosineAI/tap/cos
cos --version

Direct Download

Section titled “Direct Download”

For users who prefer not to use Homebrew:

  1. Download the latest release for your architecture from the releases page

    • Apple Silicon (M1/M2/M3): cos-darwin-arm64.zip
    • Intel Macs: cos-darwin-amd64.zip

  2. Extract and install:

    Terminal window
    unzip cos-darwin-arm64.zip
    sudo mv cos /usr/local/bin/
    cos --version

  3. (Optional) Remove quarantine attribute if prompted:

    Terminal window
    xattr -dr com.apple.quarantine /usr/local/bin/cos

Linux

Section titled “Linux”

Homebrew

Section titled “Homebrew”
Terminal window
brew install CosineAI/tap/cos
cos --version

Direct Download

Section titled “Direct Download”

  1. Download the appropriate build for your system from the releases page

    • x86_64 (most common): cos-linux-amd64.zip
    • ARM64: cos-linux-arm64.zip
    • x86_64 (Ubuntu 22.04/glibc 2.35): cos-linux-amd64-glibc2.35.zip

  2. Extract and install:

    Terminal window
    unzip cos-linux-amd64.zip
    sudo mv cos /usr/local/bin/
    cos --version

One-line Install Script

Section titled “One-line Install Script”
Terminal window
curl -fsSL https://cosine.sh/install | bash

Dependencies

Section titled “Dependencies”

For the CLI to function correctly, the following tools are required:

  • fzf - Fuzzy finder for interactive prompts
  • ripgrep - Fast code search

Install on Debian/Ubuntu:

Terminal window
sudo apt update
sudo apt install ripgrep fzf

Install on Fedora/RHEL:

Terminal window
sudo dnf install ripgrep fzf

Install on Arch:

Terminal window
sudo pacman -S ripgrep fzf

Windows

Section titled “Windows”
Section titled “Winget (Recommended)”
Terminal window
winget install Cosine.CLI
cos --version

Direct Download

Section titled “Direct Download”

  1. Download the Windows build from the releases page: cos-windows-amd64.zip

  2. Extract the zip file to a location on your PATH, such as C:\Program Files\Cosine\

  3. Add to your PATH if needed:

    • Open System Properties → Advanced → Environment Variables
    • Edit the Path variable and add the directory containing cos.exe

  4. Verify installation in PowerShell or CMD:

    Terminal window
    cos --version

Scoop (Community)

Section titled “Scoop (Community)”
Terminal window
scoop bucket add cosine https://github.com/CosineAI/scoop-bucket
scoop install cos

Authenticate the CLI

Section titled “Authenticate the CLI”

First-Time Login

Section titled “First-Time Login”

Sign in to Cosine: https://cosine.sh/login

Then, within your terminal:

Terminal window
cos login

This will:

  1. Open your browser to the Cosine login page
  2. Ask you to sign in or create an account
  3. Redirect you back to confirm successful authentication
  4. Display a success page in your browser

For the full browser and in-app sign-in flow, see Login Experience.

Authentication and Provider Access

Section titled “Authentication and Provider Access”

The CLI supports a default Cosine login plus optional provider-backed access methods:

  1. Cosine Account (default) - Use your Cosine credentials

    Terminal window
    cos login

  2. ChatGPT - Use your ChatGPT subscription for direct Codex access

    Terminal window
    cos login-with-chatgpt

  3. GitHub Copilot - Use your GitHub Copilot subscription

    Terminal window
    cos login-with-copilot

See ChatGPT and GitHub Copilot for details on each provider-backed option.

See Also

Section titled “See Also”