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

# Windsurf Auth

> Authenticate to Devin CLI using your existing Windsurf enterprise account

## Overview

Enterprise users can authenticate to Devin CLI using their existing Windsurf enterprise accounts. This provides a seamless experience for organizations already using Windsurf, with billing handled through the standard **Windsurf credit model**.

User management, team organization, SSO, RBAC, billing, and consumption are all inherited natively through the Windsurf dashboard. For most of your organizational needs, you should rely on the [Windsurf dashboard](https://windsurf.com).

> [!NOTE]
>
> Windsurf authentication for Devin CLI is available to **Windsurf Enterprise** customers. Contact your account executive if you have questions about authentication, billing, or access.

## Getting Started

### Prerequisites

Before using Windsurf authentication, ensure that:

1. Your organization has a Windsurf enterprise account
2. You have an active Windsurf user account that can use the agentic tools

> [!TIP]
>
> No additional permissions are required to access Devin CLI. If your Windsurf enterprise users can use Windsurf, they can use Devin CLI.

### Installation via Windsurf

Devin CLI is bundled with Windsurf starting with version **1.9577.24**. An admin must first enable the option in [Devin CLI Team Settings](https://windsurf.com/team/cli-settings) — see [Team Settings](https://cli.devin.ai/docs/enterprise/team-settings.md#show-install-devin-cli-in-the-windsurf-command-palette) for details.

Once enabled, open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and run **Install Devin CLI**.

Alternatively, you can install using the standalone installer — see the [Quickstart](https://cli.devin.ai/docs/index.md) for instructions.

### Authenticating

To authenticate with your Windsurf enterprise account:

```bash theme={null}
devin auth login
```

Follow the prompts and be sure to select the **Log in with Windsurf for Enterprise** option to authenticate through your organization's identity provider.

### Credentials file location

After `devin auth login`, Devin CLI stores your API token in `credentials.toml`. By default, this token is persistent and does not expire. You can copy the credentials file between your own machines to reuse the same authentication, but treat it as sensitive: anyone with this file can authenticate as you. Do not share it or commit it to source control.

| Platform | Location |
| - | - |
| macOS / Linux | `$XDG_DATA_HOME/devin/credentials.toml` when `XDG_DATA_HOME` is set; otherwise `~/.local/share/devin/credentials.toml` |
| Windows | `%APPDATA%\devin\credentials.toml` (typically `C:\Users\<you>\AppData\Roaming\devin\credentials.toml`) |

Run `devin auth logout` to remove stored credentials.

## Billing & Analytics

Usage through Devin CLI is billed using the standard **Windsurf credit model**. All Devin CLI usage counts toward your organization's existing Windsurf enterprise allocation.

The analytics and billing system are shared between Windsurf and Devin CLI. Use the [Team Members dashboard](https://windsurf.com/team/members) to manage team organization or view consumption metrics across both products.

Enterprise admins can also access usage analytics programmatically through the [Windsurf API](https://docs.windsurf.com/windsurf/accounts/api-reference/api-introduction) to monitor consumption across their organization.

For details about credit billing and usage tracking, refer to your enterprise agreement or contact your account executive.

## Further Reading

For more information about Windsurf enterprise features, see the [Windsurf documentation](https://docs.windsurf.com/):

* [Guide for Admins](https://docs.windsurf.com/windsurf/guide-for-admins) — Administration and team management
* [SSO & SCIM](https://docs.windsurf.com/windsurf/accounts/sso-scim) — Single sign-on and user provisioning
* [API Reference](https://docs.windsurf.com/windsurf/accounts/api-reference/api-introduction) — Access analytics and usage data


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.