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

# Get started

> Boost your developers' productivity while keeping your code secure

***

Symbiotic Code is a security-first coding agent that runs in your terminal. To use it you will need:

* **A terminal**: Use the default terminal, or a modern terminal emulator like [iTerm](https://iterm2.com) or [Warp](https://warp.dev). It can also run in an IDE terminal (e.g., VS Code terminal).
* **A Symbiotic Security account**: Ask your admin or Symbiotic point of contact for access.

## Installation

### CLI install

Install Symbiotic Code with your preferred package manager:

```bash theme={null}
npm install -g @symbioticsec/code
```

You can also use `pnpm install -g @symbioticsec/code`, `yarn global add @symbioticsec/code`, or `bun install -g @symbioticsec/code`. The installer is available for curl-based installations:

```bash theme={null}
curl -fsSL https://github.com/SymbioticSec/symcode/releases/latest/download/install.sh | bash
```

<Accordion title="Error during installation ?">
  Check that **node** and **npm** are properly installed:

  ```bash theme={null}
    node -v
    npm -v
  ```

  If they are not installed, install [them](https://nodejs.org/en/download/) and retry.
</Accordion>

To launch Symbiotic Code, use the `symbiotic` command in your terminal:

```bash theme={null}
symbiotic
```

### IDE extension install

[Download](https://app.symbioticsec.ai/symbiotic-code.vsix) our extension and install it in all VSCode based IDEs.

## Authentication

<Info>
  A Symbiotic Security account is required. If you don't have access, contact your administrator or Symbiotic point of contact.
</Info>

On first launch, you'll be prompted to enter your personal access token:

<Steps>
  Click the link in the authentication modal to open the [Symbiotic Portal](https://app.symbioticsec.ai)

  Create a new token or copy an existing one from your account settings

  Paste the token in the dialog and press `Enter`

  Your token is **securely stored** and used for all subsequent operations.
</Steps>

Symbiotic Code detects whether it was installed with npm, pnpm, yarn, Bun, or the installer and uses the same method when checking for and applying updates.
