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

# Connect your agent

Give your existing agent a short note that tells it how to find business details and use provider keys. For a single task, copy a note with that task's setup. For future sessions, append a generic note to your agent's instruction files.

## Review and add the note

Run `godmode agents`, or select **Connect agent** in the main menu.

1. Choose **Add to agent files** and select one agent or **All detected agents**.
2. Scroll through the full preview. Check the destinations and added lines.
3. Press Enter to append the note. Start a fresh agent session so it can load the file.

Godmode detects Claude Code, Codex, Gemini CLI, Copilot CLI, and OpenCode from existing folders. It preserves existing text and skips files that already mention `godmode help` or contain a Godmode marker, including edited notes.

If a file changes during review, reopen the preview. Godmode shows the resolved destination for links and refuses unsafe files. If the preview is hard to review in your terminal, try `godmode --plain agents` for numbered choices and a text preview.

## Check that it works

In the fresh session, ask the agent to run `godmode help`. It should describe the selected setup and list saved key names. For a task that uses a provider, have the agent confirm access to the expected account and resource with a read.

## Use another agent or one project

Choose **Copy for this task**, then press Enter to copy the note. Paste it into the current conversation. You can also print it directly:

```sh
godmode agents --print
```

For project-wide instructions, add the text to the file your agent already reads in that project. When sharing it across tasks, review the pinned setup in the note.

## Pin a task to one setup

A task note includes the selected key environment, business profile, and custom home if you use one. With the global note, capture the command prefix once at the start of each task:

```sh
godmode active --command
```

Use that prefix for every Godmode call in the task. See [Businesses and environments](/docs/v0.20.0/contexts#give-an-agent-the-selection).

## Fix a missing command or wrong home

For a default install, run `~/.godmode/bin/godmode` if the agent's PATH omits it. For a custom home, pass `--home DIR` or set `GODMODE_HOME` as well. For an agent running on another host, see [Remote machines](/docs/v0.20.0/remote).

## Remove the note

Delete the block from `<!-- godmode:start -->` through `<!-- godmode:end -->` in each file you changed. Start a fresh agent session.
