Skip to content

Commit a1be6f8

Browse files
hyperpolymathclaude
andcommitted
docs(desktop-icons): update paths for in-repo scaffolder-managed launcher
The PanLL launcher is now at /var/mnt/eclipse/repos/panll/panll-launcher.sh, not /var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh. The pre-2026-04-10 copy under .desktop-tools/ was archived to .desktop-tools/.archive-2026-04-10/ when the launcher was migrated to launch-scaffolder management. This doc had six stale path references to the archived copy — all updated to point at the in-repo copy, plus a top-of-doc banner explaining the migration so anyone hitting this doc from search results understands why the old path is gone. No change to the troubleshooting advice itself — the scaffolder-generated script exposes the same URL=... configuration shape as the old hand-written launcher, so the port-matching diagnostics below the banner still apply as-is. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent da5ffda commit a1be6f8

1 file changed

Lines changed: 16 additions & 6 deletions

File tree

FIXING-DESKTOP-ICONS.md

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,15 @@
11
# Fixing PanLL Desktop Icon Issues
22

3+
> **Updated 2026-04-10.** The PanLL launcher is now scaffolder-managed
4+
> and lives **in-repo** at `/var/mnt/eclipse/repos/panll/panll-launcher.sh`.
5+
> It is regenerated by
6+
> [`launch-scaffolder`](https://github.com/hyperpolymath/launch-scaffolder)
7+
> from `panll.launcher.a2ml`. The pre-2026-04-10 hand-written copy
8+
> under `~/.desktop-tools/panll-launcher.sh` was archived to
9+
> `~/.desktop-tools/.archive-2026-04-10/` and should not be used.
10+
> This document has been updated to reference the new path; the
11+
> advice below still applies to the scaffolder-generated script.
12+
313
## Problem
414
The PanLL desktop icon shows an error: "Unable to make the service PanLL executable, aborting execution. Existing file /home/hyper/Desktop/panll.desktop is not writable."
515

@@ -35,7 +45,7 @@ sudo chmod 444 /home/hyper/Desktop/panll.desktop
3545
## Current Status
3646

3747
**Desktop file is properly configured**
38-
- Exec: `/var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh serve`
48+
- Exec: `/var/mnt/eclipse/repos/panll/panll-launcher.sh serve`
3949
- Terminal: false
4050
- Permissions: 444 (read-only, secure)
4151

@@ -48,8 +58,8 @@ sudo chmod 444 /home/hyper/Desktop/panll.desktop
4858
## How to Launch
4959

5060
1. **From desktop icon**: Click the PanLL icon in your desktop environment
51-
2. **From terminal**: `/var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh serve`
52-
3. **Stop**: `/var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh stop`
61+
2. **From terminal**: `/var/mnt/eclipse/repos/panll/panll-launcher.sh serve`
62+
3. **Stop**: `/var/mnt/eclipse/repos/panll/panll-launcher.sh stop`
5363

5464
## Verification
5565

@@ -71,7 +81,7 @@ If it still doesn't work:
7181
1. **Check Gossamer**: `command -v gossamer && gossamer --version`
7282
2. **Check Deno**: `command -v deno && deno --version`
7383
3. **Check actual port**: `ss -tlnp | grep deno` or `lsof -i :8000`
74-
4. **Verify launcher port matches**: `grep "URL=" /var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh`
84+
4. **Verify launcher port matches**: `grep "URL=" /var/mnt/eclipse/repos/panll/panll-launcher.sh`
7585
5. **Update launcher if needed**: Change URL in launcher to match actual server port
7686
6. **Run diagnostics**: `panll-dustfile.sh --diagnose`
7787
7. **Try repair**: `panll-dustfile.sh --repair`
@@ -85,10 +95,10 @@ The launcher and server ports must match:
8595
ss -tlnp | grep deno
8696

8797
# Check what port the launcher expects
88-
grep "URL=" /var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh
98+
grep "URL=" /var/mnt/eclipse/repos/panll/panll-launcher.sh
8999

90100
# If they don't match, update the launcher:
91-
sed -i 's|URL="http://localhost:3000"|URL="http://localhost:8000"|' /var/mnt/eclipse/repos/.desktop-tools/panll-launcher.sh
101+
sed -i 's|URL="http://localhost:3000"|URL="http://localhost:8000"|' /var/mnt/eclipse/repos/panll/panll-launcher.sh
92102
```
93103

94104
Default ports:

0 commit comments

Comments
 (0)