claude-code - 💡(How to fix) Fix [BUG] ultraplan: cannot launch remote session

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

❯ what exactly do i need to do?

● 1. Open this link: https://github.com/apps/claude/installations/new 2. Select your account (sturlan) 3. Choose Only select repositories → pick myrepo 4. Click Install

Then come back and run /ultraplan again.

✻ Sautéed for 2s

❯ /ultraplan ⎿ Usage: /ultraplan <prompt>, or include "ultraplan" anywhere in your prompt

 Remote plan mode with rich web editing experience.
 Runs in Claude Code on the web. When the plan is ready,
 you can execute it in the web session or send it back here.
 You can continue to work while the plan is generated remotely.

 Terms: https://code.claude.com/docs/en/claude-code-on-the-web

❯ /ultraplan try plan
◇ ultraplan ⎿ Starting Claude Code on the web…

❯ ultraplan: cannot launch remote session —
The Claude GitHub app must be installed on this repository first.
https://github.com/apps/claude/installations/new

● Still the same error — the app install likely didn't take. A few things to check:

  1. Go to https://github.com/settings/installations and confirm the Claude app appears there
  2. If it does, click Configure and make sure drvodom-ai-ocr is in the list of selected repositories
  3. If it doesn't appear at all, try the install link again: https://github.com/apps/claude/installations/new

What do you see at that settings page?

✻ Cogitated for 4s

❯ it's installed, and it has myrepo repo

● Try running /ultraplan try plan once more — there can be a short propagation delay after app installation. If it still fails, it may be worth checking https://github.com/sturlan/drvodom-ai-ocr is accessible (not empty, has at least one commit) — which it is — so it should work now.

✻ Churned for 7s

❯ /ultraplan try plan again
◇ ultraplan ⎿ Starting Claude Code on the web…

❯ ultraplan: cannot launch remote session —
The Claude GitHub app must be installed on this repository first.
https://github.com/apps/claude/installations/new

● This looks like a bug — the app is installed and the repo is accessible, but Ultraplan isn't picking it up. I'd suggest reporting it at https://github.com/anthropics/claude-code/issues with these details:

  • Repo: sturlan/myrepo
  • App installed: yes (visible at github.com/settings/installations)
  • Error: "Claude GitHub app must be installed on this repository first"

Code Example

❯ what exactly do i need to do?                                                                                                                                                                                                             

1. Open this link: https://github.com/apps/claude/installations/new
  2. Select your account (sturlan)
  3. Choose Only select repositories → pick myrepo
  4. Click Install

  Then come back and run /ultraplan again.
  
 Sautéed for 2s

/ultraplan 
Usage: /ultraplan <prompt>, or include "ultraplan" anywhere
     in your prompt

     Remote plan mode with rich web editing experience.
     Runs in Claude Code on the web. When the plan is ready,
     you can execute it in the web session or send it back here.
     You can continue to work while the plan is generated remotely.

     Terms: https://code.claude.com/docs/en/claude-code-on-the-web

/ultraplan try plan                                                                                                                                                                                                                       
◇ ultraplan
Starting Claude Code on the web…
  
❯ ultraplan: cannot launch remote session —                                                                                                                                                                                                 
  The Claude GitHub app must be installed on this repository first.                                                                                                                                                                         
  https://github.com/apps/claude/installations/new                                                                                                                                                                                          

Still the same error — the app install likely didn't take. A few things to check:
  
  1. Go to https://github.com/settings/installations and confirm the Claude app appears there
  2. If it does, click Configure and make sure drvodom-ai-ocr is in the list of selected repositories
  3. If it doesn't appear at all, try the install link again: https://github.com/apps/claude/installations/new

  What do you see at that settings page?

Cogitated for 4s
  
❯ it's installed, and it has myrepo repo                                                                                                                                                                                            

Try running /ultraplan try plan once more — there can be a short propagation delay after app installation. If it still fails, it may be worth checking https://github.com/sturlan/drvodom-ai-ocr is accessible (not empty, has at least
  one commit) — which it is — so it should work now.

 Churned for 7s

/ultraplan try plan again                                                                                                                                                                                                                 
◇ ultraplan
Starting Claude Code on the web…
  
❯ ultraplan: cannot launch remote session —                                                                                                                                                                                                 
  The Claude GitHub app must be installed on this repository first.                                                                                                                                                                         
  https://github.com/apps/claude/installations/new                                                                                                                                                                                          

This looks like a bug — the app is installed and the repo is accessible, but Ultraplan isn't picking it up. I'd suggest reporting it at https://github.com/anthropics/claude-code/issues with these details:
  
  - Repo: sturlan/myrepo
  - App installed: yes (visible at github.com/settings/installations)
  - Error: "Claude GitHub app must be installed on this repository first"
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

❯ /ultraplan try plan
◇ ultraplan ⎿ Starting Claude Code on the web…

❯ ultraplan: cannot launch remote session —
The Claude GitHub app must be installed on this repository first.
https://github.com/apps/claude/installations/new

● This is definitely a bug on Ultraplan's side — the app is correctly installed. I'd suggest filing an issue at https://github.com/anthropics/claude-code/issues so the team can investigate.

Want to skip Ultraplan and just start building the service here? We have everything we need from the handout.

What Should Happen?

i am not sure, i guess ultraplan needs to start

Error Messages/Logs

❯ what exactly do i need to do?                                                                                                                                                                                                             

1. Open this link: https://github.com/apps/claude/installations/new
  2. Select your account (sturlan)
  3. Choose Only select repositories → pick myrepo
  4. Click Install

  Then come back and run /ultraplan again.
  
✻ Sautéed for 2s

❯ /ultraplan 
  ⎿  Usage: /ultraplan <prompt>, or include "ultraplan" anywhere
     in your prompt

     Remote plan mode with rich web editing experience.
     Runs in Claude Code on the web. When the plan is ready,
     you can execute it in the web session or send it back here.
     You can continue to work while the plan is generated remotely.

     Terms: https://code.claude.com/docs/en/claude-code-on-the-web

❯ /ultraplan try plan                                                                                                                                                                                                                       
◇ ultraplan
  ⎿  Starting Claude Code on the web…
  
❯ ultraplan: cannot launch remote session —                                                                                                                                                                                                 
  The Claude GitHub app must be installed on this repository first.                                                                                                                                                                         
  https://github.com/apps/claude/installations/new                                                                                                                                                                                          

● Still the same error — the app install likely didn't take. A few things to check:
  
  1. Go to https://github.com/settings/installations and confirm the Claude app appears there
  2. If it does, click Configure and make sure drvodom-ai-ocr is in the list of selected repositories
  3. If it doesn't appear at all, try the install link again: https://github.com/apps/claude/installations/new

  What do you see at that settings page?

✻ Cogitated for 4s
  
❯ it's installed, and it has myrepo repo                                                                                                                                                                                            

● Try running /ultraplan try plan once more — there can be a short propagation delay after app installation. If it still fails, it may be worth checking https://github.com/sturlan/drvodom-ai-ocr is accessible (not empty, has at least
  one commit) — which it is — so it should work now.

✻ Churned for 7s

❯ /ultraplan try plan again                                                                                                                                                                                                                 
◇ ultraplan
  ⎿  Starting Claude Code on the web…
  
❯ ultraplan: cannot launch remote session —                                                                                                                                                                                                 
  The Claude GitHub app must be installed on this repository first.                                                                                                                                                                         
  https://github.com/apps/claude/installations/new                                                                                                                                                                                          

● This looks like a bug — the app is installed and the repo is accessible, but Ultraplan isn't picking it up. I'd suggest reporting it at https://github.com/anthropics/claude-code/issues with these details:
  
  - Repo: sturlan/myrepo
  - App installed: yes (visible at github.com/settings/installations)
  - Error: "Claude GitHub app must be installed on this repository first"

Steps to Reproduce

try to start ultraplan from claude code CLI

Claude Model

Opus

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

Claude Code v2.1.148

Platform

Anthropic API

Operating System

Ubuntu/Debian Linux

Terminal/Shell

Other

Additional Information

No response

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [BUG] ultraplan: cannot launch remote session