> Godmode v0.20.0 documentation · Reviewed 2026-11-19
> Source: https://godmode.build/docs/quickstart

# Quickstart

Connect one provider account to your coding agent and run a read-only check.

## Install

Use bash or zsh on macOS or Linux (ARM64 or x86-64), with Python 3.9 or later.

```sh
curl -fsSL https://get.godmode.build | bash
```

Open a new terminal or run `. ~/.godmode/env` in your current shell. Check with `godmode --version`. See [Installation](/install) for downloads and existing installs.

## Add what your task needs

```sh
godmode
```

Open **Provider keys** and choose the account your task needs. Follow the provider's steps, paste the key at the masked prompt, then review and save it. For GitHub, you can jump straight to `godmode setup github`.

If the provider's CLI already has the right login, use it directly. Add **Business details** only if the task needs them. [Credentials and native logins](/docs/credentials) covers both access paths.

## Connect your agent

```sh
godmode agents
```

- **Copy for this task** gives you a note to paste into an open agent session. You can also print it with `godmode agents --print`.
- **Add to agent files** lets you select detected agent files and review the additions before saving. Start a fresh agent session in your project so it can load the saved note.

See [Connect your agent](/docs/agents) to check the setup from inside the agent.

## Verify one account

Give your agent this task with the bracketed details filled in.

```text
Run godmode help, then read godmode provider [provider].
Use my existing login or only the saved keys this check needs.
Check that you can read [project] in [account].
Report the account and project you verified. Keep credentials private.
```

A saved key only confirms local storage. A successful read confirms access to the resource you checked. [Build an app](/docs/launch) or [change an existing one](/docs/changes) once you have the right account.

## Choose the active setup

Open **Switch setup** to choose a key environment and business profile for future commands. Run `godmode active` to check your selection. [Pin both selections](/docs/contexts#give-an-agent-the-selection) for a task that needs a specific account.

## Display options

On first use, Enter advances the intro. Use `godmode --no-motion` for a still intro or `godmode --plain` for numbered menus. Use **Settings → Motion** to save the motion preference.
