Skip to content

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.

View Markdown

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:

Shell
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:

Shell
godmode active --command

Use that prefix for every Godmode call in the task. See Businesses and environments.

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.

Remove the note#

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

Godmode v0.20.0 · 2026-11-19 · Inspect the source · Get help