Beta Coming soon. This feature is still being built, so names and details may change before it ships.

Agent hand-off

Send a chat or its plan to an Ingot cloud agent in one click. The cloud agent picks up the task on your GitHub repository, runs the tests and opens a draft pull request. You follow the run, review the pull request, check out its branch and ask for changes, all from Ingot.

The Cloud Agents panel: a finished run with its draft PR, the files it changed, the run log and Review PR, Changes, Open on GitHub and Check Out BranchThe Cloud Agents panel: a finished run with its draft PR, the files it changed, the run log and Review PR, Changes, Open on GitHub and Check Out Branch
The Cloud Agents panel: a finished run with its draft PR, the files it changed, the run log and Review PR, Changes, Open on GitHub and Check Out Branch

Before you start

You needWhere
An Ingot account on a plan with cloud agentsAccount: Sign in to Ingot… in Find Action
A GitHub origin remote in the projectgit remote -v shows github.com/<owner>/<repo>
GitHub connected to the cloud agentThe portal's cloud agent page (/bot). The Connect GitHub button in the panel opens it

The first time you send from a repository the cloud agent can see but was not given yet, the panel says so and shows Allow Repository. Click it and Ingot adds the repository and sends the same chat again.

Send a chat

Click the cloud button in the Agents panel header, or run Send Chat to Cloud Agent (⌘⌥⇧Q, Ctrl+Alt+Shift+Q, also in Find Action). The Cloud Agents panel opens at the bottom with the new run, and the chat gets a Sent to cloud agent note with Show run.

Ingot packs the chat into a short brief for the cloud agent (at most 4,000 characters):

Part of the briefTaken from
TitleThe chat title, or the first line of your first message. The pull request and its branch are named after it
Goal and Latest requestYour first message, and the last one when it is different
PlanThe chat's plan, with [x] on the steps that are done
Where the local agent stoppedThe agent's last reply
Files involvedFiles the agent changed and files you attached
RepositoryThe GitHub repository, its default branch, and what the cloud agent will not see

Build a plan in the cloud

In Plan mode, the plan reply has Build in Cloud next to Build. It sends the plan's steps instead of the whole chat (Send Plan to Cloud Agent in Find Action). The cloud agent works through the steps that are not done yet.

The brief for a plan in the Cloud Agents panel, ready to edit before Send, with a warning about an uncommitted fileThe brief for a plan in the Cloud Agents panel, ready to edit before Send, with a warning about an uncommitted file
The brief for a plan in the Cloud Agents panel, ready to edit before Send, with a warning about an uncommitted file

What the cloud agent starts from

The cloud agent clones your repository on GitHub and starts from its default branch. Anything that is only on your machine is not in its workspace, and the panel warns you before and after you send:

WarningWhat to do
2 uncommitted files stay on this machine; the cloud agent starts from main.Commit and push them first if the cloud agent needs them
3 unpushed commits on feature/csv are not in the cloud workspace.Push the branch, or merge it into the default branch
The cloud agent starts from main, not feature/csv.Fine when the task does not depend on your branch

Follow the run

The Cloud Agents panel (⌘⌥⇧', Ctrl+Alt+Shift+', or Cloud Agents in Find Action) lists your hand-offs, newest first, with their status: Queued, Running, Needs approval, Done, Failed, Cancelled or Timed out. Select a run to see its log as it works: the clone, the files it changed, the commands it ran and the pull request it opened. Cancel Run stops a run that is still working.

Runs started from Ingot in another window show up too. Click the refresh button to load them.

When the cloud agent opens its draft pull request, Ingot tells you: The cloud agent opened draft PR #7. with Review in Ingot and Show run.

Review the pull request in Ingot

ButtonWhat it does
Review PR #7Runs AI code review on the pull request. Findings open in the Review panel and in the editor, and Post to GitHub PR comments them on the pull request
ChangesLists the files with added and removed lines. Click a file to see its diff
Open on GitHubOpens the pull request in your browser
Check Out BranchFetches the cloud agent's branch and checks it out, so you can run and test it here. Ingot refuses while you have uncommitted changes, so nothing is lost
The Review panel after Review PR on the cloud agent's pull request, with the review resultThe Review panel after Review PR on the cloud agent's pull request, with the review result
The Review panel after Review PR on the cloud agent's pull request, with the review result

Ask for changes

Under a finished run with a pull request, type what you want changed and click Follow Up. A new run starts on the same pull request and appears in the list as Follow-up: <title>.

Settings

Settings › Tools › Cloud agents:

SettingDefaultWhat it does
ingot.cloudAgent.modelCloud defaultThe model the cloud agent runs with: Ingot, Ingot Smart, Ingot Fast, Claude Sonnet 4.5, GPT-4.1 or Gemini 2.5 Pro. Cloud default uses the model chosen on the portal
ingot.cloudAgent.confirmBeforeSendOffShow the brief in the panel first, so you can edit it, then Send or Discard
ingot.cloudAgent.reviewWhenReadyOffRun Review PR as soon as the pull request opens

Keyboard shortcuts

ActionmacOSWindows / Linux
Send Chat to Cloud Agent⌘⌥⇧QCtrl+Alt+Shift+Q
Cloud Agents panel⌘⌥⇧'Ctrl+Alt+Shift+'

Send Plan to Cloud Agent, Review Cloud Agent PR in Ingot, Check Out Cloud Agent Branch, Cancel Cloud Agent Run and Refresh Cloud Agent Runs are in Find Action.

Privacy

Your session token stays in Ingot's backend; the panel never sees it. Only the brief is sent: your messages, the plan, the agent's last reply and the names of the files involved. The cloud agent reads the code itself from GitHub, with the access you gave it on the portal.

From the terminal

ingot handoff sends the same brief from the command line, with a personal access token (ingot_pat_…, from your dashboard) in --token or INGOT_TOKEN:

ingot handoff send --prompt "Add CSV export to the reports page" --watch
ingot handoff send --plan plan.md --dry-run      # print the brief, send nothing
ingot handoff list
ingot handoff checkout <run>
CommandWhat it does
send--prompt or --file with the task, --plan with a plan file, --repo owner/name (default: the origin remote), --model, --allow to give the cloud agent the repository first, --watch to follow the run
listThe latest 20 runs with their status, repository and pull request
status <run>The run, its pull request and its log; --watch follows it and exits 3 when it does not succeed
cancel <run>Stops a run
followup <run> --prompt <text>A new run on the same pull request
checkout <run>Fetches and checks out the run's branch (refuses over uncommitted changes)

Every command takes --json. The server is --server, then INGOT_SERVER_URL, then https://www.ingotide.com.