Skip to main content

API Key

Neusis Code authenticates to the cloud provider with a single API key. There is no interactive login flow — the key is collected once during install and written into your config.

If you don't have a key yet, request it from admin@neusis.ai or through the early access form.

How the key is set​

The install script prompts for your API key during setup and writes it to your global config at ~/.config/neusiscode/neusiscode.json, under the neusiscode provider:

{
  "provider": {
    "neusiscode": {
      "options": {
        "apiKey": "<your-api-key>"
      }
    }
  }
}

On macOS / Linux the installer reads the key from the terminal, so it works even under curl | sh. On Windows the PowerShell installer prompts for it the same way.

:::note Upgrades preserve your key Re-running the install command rewrites the rest of your config to the latest format but preserves the existing API key — you are not prompted again once a key is present. See Installation. :::

Editing or rotating the key​

The key is plain JSON, so you can update it by editing the apiKey value in ~/.config/neusiscode/neusiscode.json directly. The change takes effect the next time you start Neusis Code. For the full config layout and precedence rules, see Configuration.

:::warning Keep it secret Your API key is tied to your workspace. Keep it secure and never commit it to version control. :::