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

# RightNow Agent

> Configure RightNow Agent's RunInfra provider with your workspace key and a serving model.

RightNow Agent ships with RunInfra as its default provider. Use your workspace API key and an available model to connect it.

## Connect RightNow Agent

Install RightNow Agent on macOS or Linux:

```bash theme={"dark"}
curl -fsSL https://releases.rightnowai.co/cli/install.sh | bash
```

Follow the installer's PATH instructions, then check the installation:

```bash theme={"dark"}
rightnow --version
rightnow doctor
```

Read the [RightNow quickstart](https://www.rightnowai.co/docs/quickstart) for platform prerequisites and the Windows installer.

Get a workspace key from [API keys](https://runinfra.ai/keys). Load it into `RUNINFRA_GATEWAY_KEY` through your secret-management workflow, then pass it to RightNow in the terminal you will use to launch it:

```bash theme={"dark"}
export RIGHTNOW_API_KEY="$RUNINFRA_GATEWAY_KEY"
```

For RunInfra, `RIGHTNOW_API_KEY` takes priority over `RUNINFRA_GATEWAY_KEY`. A nonempty environment credential overrides a stored key. Keep the key out of `config.toml`.

You can use the native credential flow instead:

```bash theme={"dark"}
rightnow auth login
```

Without a usable provider credential, launching `rightnow` opens its Connect screen. Select RunInfra and enter your key. Use `/connect` to reopen that screen in a session. See [RightNow authentication](https://www.rightnowai.co/docs/authentication).

## Configure manually

Review `~/.rightnow/config.toml`, then merge these settings. On Windows, the default path is `$HOME\.rightnow\config.toml`. If you set `RIGHTNOW_HOME`, use `config.toml` in that directory.

The provider id is `runinfra`. [RightNow's shipped example](https://www.rightnowai.co/docs/providers) sets `context_window = 1048576`.

This guide selects Nemotron 3.5 Lightning 30B, listed as available on September 21, 2026. Set both context windows to `262144` because that is its [published context limit](https://runinfra.ai/inference-api/nemotron-3-5-lightning-30b).

```toml theme={"dark"}
[models]
default = "runinfra"

[model_providers.runinfra]
base_url = "https://api.runinfra.ai/v1"
env_key = "RIGHTNOW_API_KEY"
supports_tool_choice_required = false
context_window = 262144

[model.runinfra]
model = "nemotron-3-5-lightning-30b"
model_provider = "runinfra"
name = "RightNow (RunInfra)"
context_window = 262144
auto_compact_threshold_percent = 85
```

The `runinfra` model-entry id selects the entry above. Its `model` field names the upstream model. [RightNow providers](https://www.rightnowai.co/docs/providers) states: "The -m option selects a model-entry ID."

Run [`GET /v1/models`](/docs/api-reference/models) for the current list; a model that is temporarily paused is reported there and on its Model Library page.

## Verify

Inspect the model selection and credential source:

```bash theme={"dark"}
rightnow models
rightnow auth status
```

Confirm that the selected provider is RunInfra, then start a session in your project root:

```bash theme={"dark"}
rightnow
```

Type `Summarize this workspace` and press **Enter**. Prompts and relevant tool results go to the selected provider. Requests use your RunInfra credits.

## Restart

Restart RightNow from the terminal containing your key environment. Recheck `rightnow auth status` after changing the environment, stored key, or configuration.

## Troubleshooting

| Symptom                               | What to check                                                                                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| RightNow uses a different key         | Check `rightnow auth status`. A nonempty `RIGHTNOW_API_KEY` overrides `RUNINFRA_GATEWAY_KEY` and the stored key.                     |
| The selected model is unavailable     | Check `GET /v1/models`, then update the upstream `model` and its `context_window`. `rightnow models` lists configured model entries. |
| The expected configuration is missing | Check the active `RIGHTNOW_HOME` and run `rightnow doctor`.                                                                          |

## Revert

Restore the previous model and provider values in `config.toml`. Remove only the entries you added for this setup.

To remove RunInfra's stored key:

```bash theme={"dark"}
rightnow auth logout runinfra
```

An environment credential remains active after logout. Remove your RightNow environment assignment if you no longer need it. Keep a shared `RUNINFRA_GATEWAY_KEY` if another client uses it.

## Related

<Columns cols={3}>
  <Card title="Connect" icon="plug" href="/docs/tools-sdks/connect">
    Find coding-agent setup guides.
  </Card>

  <Card title="Authentication" icon="key" href="/docs/api-reference/authentication">
    Set your RunInfra workspace key.
  </Card>

  <Card title="Models" icon="list" href="/docs/api-reference/models">
    Find model ids and availability.
  </Card>
</Columns>