[Bug]: Pi setup suggests installation without guiding reuse of an existing off-PATH runtime and profile

Offen
#36,157 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@juliusmarminge arbeitet bereits daran.

Seit 13.11.2026.

  • #36162 von @juliusmarminge — offen

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
30/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Veraltet
Tech-Stack
node.js, typescript
Bereich
frontend

Rechercherichtung

The report concerns the Pi provider card under apps/web, specifically the 'Not found' diagnostic shown when the default pi command is missing from PATH. Start by locating that message and the Binary path setting it should reference. Done means the failure text points to both installing Pi and setting Binary path, and mentions PI_CODING_AGENT_DIR for an existing profile. Pull request #36162 already targets this, so check it before starting.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Before submitting
  • I searched existing issues and did not find an exact duplicate.
  • I included the observed setup, executable verification, and related reports.
Area

apps/web

Steps to reproduce

Observed on an existing macOS installation:

  1. Have Pi Web installed in a user-level, isolated runtime, with its own Pi agent directory and existing custom-model configuration.
  2. Launch T3 Code desktop and enable Pi in Settings → Providers. Leave Binary path at its default, pi.
  3. The Pi executable is not on T3's PATH, although it exists inside the Pi Web runtime.
  4. Open the Pi provider card.
Actual behavior

The card shows:

Not found · Pi CLI (pi) is not installed or not on PATH. Install with npm install -g --ignore-scripts @earendil-works/pi-coding-agent.

The installation instruction is prominent, while this diagnostic does not point to Binary path or explain that an existing installation may use a separate agent directory.

In this case, Pi was already installed and its GUI service was running. The existing CLI answered:

node "$HOME/Library/Application Support/Pi Agent/runtime/node_modules/@earendil-works/pi-coding-agent/dist/bundle/cli.js" --version
# 1.5.0

There is also a runtime/node_modules/.bin/pi symlink. The existing profile is under $HOME/Library/Application Support/Pi Agent/agent, and already contains custom-model configuration.

The lookup failure itself is understandable: this private runtime is outside PATH. The problem is the recovery guidance. It encouraged a reinstall diagnosis even though the executable and configuration were already present.

Expected behavior

The default-command lookup failure should point directly to both supported recovery options:

  • Install Pi if it is absent.
  • Reuse an existing executable through Binary path.

For an existing installation, setup should also explain PI_CODING_AGENT_DIR so users can retain their models, authentication, and extensions rather than accidentally starting with a different profile. A file/directory picker or clear inline example would make this much easier.

This is a setup/diagnostic usability report, not a claim that T3 should automatically scan and execute arbitrary bundled dependencies. The provider documentation already describes manual configuration; the missing guidance is in the failure state where it is needed.

Impact

Minor bug or occasional failure. It makes a working installation look like it needs another installation and makes reuse of an existing model profile difficult to discover.

Version or commit

T3 Code (Beta) 0.1.9

Environment

macOS 27.0, arm64; Node.js 24.14.1; Pi Web @agegr/[email protected]; bundled @earendil-works/[email protected].

Workaround / verification limits

The existing CLI was verified directly. Configuring T3 with that executable and the original agent directory is the documented reuse route, but I have not yet completed an end-to-end T3 conversation with this installation.

Related: #35373 concerns a nonexistent custom Binary path; here the default lookup is used and the real executable exists elsewhere. #28714 concerns startup PATH capture, not discovery of a GUI-private runtime.

Vorherrschende Sprache
TypeScript
Sterne
24.8k
Forks
6.4k
Ø Merge
59 Min.
Gemergte PRs (30 T.)
418

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus pingdotgg/t3code

Alle Issues in pingdotgg/t3code

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.