Skip to content

chore: retire legacy npm packages (claude-remote, remo-code-supervisor npm)#72

Merged
finedesignz merged 4 commits into
mainfrom
chore/retire-npm-packages
May 26, 2026
Merged

chore: retire legacy npm packages (claude-remote, remo-code-supervisor npm)#72
finedesignz merged 4 commits into
mainfrom
chore/retire-npm-packages

Conversation

@finedesignz
Copy link
Copy Markdown
Owner

@finedesignz finedesignz commented May 26, 2026

Retires the legacy npm-distributed local apps for Remo Code. The Tauri Supervisor desktop app (Windows MSI from https://github.com/finedesignz/remo-code/releases/latest) is now the only supported local app.

Five atomic phases (one commit each)

A. chore: delete agent/ workspace and publish-agent CI

  • Delete agent/ workspace (src, test, package.json, tsconfig).
  • Drop agent from root package.json workspaces.
  • Delete .github/workflows/publish-agent.yml.
  • Hub /ws/agent route is UNCHANGED — the Tauri supervisor still connects there.

B. chore: drop supervisor npm publishing surface (keep Tauri sidecar)

  • Delete supervisor/package.json and supervisor/README.md.
  • Drop supervisor from root workspaces.
  • KEEP supervisor/src/ (Tauri sidecar source — bundled into the MSI via bun build --compile).
  • KEEP supervisor/tauri/ and .github/workflows/release-supervisor.yml.

C. chore(hub): remove dead /ws/channel route and verifyChannelToken

  • Delete hub/src/ws/channel.ts.
  • Drop /ws/channel from the upgrade router, wsData dispatch, and open/message/close handlers in hub/src/index.ts.
  • Delete ChannelAuth, AssistantMessage, ChannelStatus, ChannelInbound Zod schemas from hub/src/ws/protocol.ts.
  • Delete verifyChannelToken DAL helper from hub/src/db/dal.ts.

D. docs+web: retire npm-package install paths, link Tauri MSI release

  • Web UI: rewrite ConnectModal.tsx as Tauri-MSI-only; remove the legacy agent <details> fallback blocks from ApiKeyModal.tsx and SettingsPage.tsx; drop claude-remote wording from Sidebar.tsx tooltips.
  • Repo docs: rewrite README.md Quick Start + Architecture + Project Structure; rewrite CLAUDE.md Commands + Local Supervisor + WebSocket Protocol + Key Design Decisions; delete docs/agent.md.
  • Planning docs: prepend a Phase 09 banner to .planning/codebase/*, .planning/STATE.md, .planning/ROADMAP.md, .planning/REQUIREMENTS.md, .planning/debug/cannot-connect-new-servers.md, and historical phase plans (04, 05, 06, 07, merge-self-heal). Historical content is preserved.
  • docs/superpowers/specs/* and docs/superpowers/plans/*: annotate, do not rewrite.

E. Memory + global ~/.claude/CLAUDE.md sweep (outside this repo)

  • ~/.claude/projects/C--Users-artic-GitHub-remo-code/memory/: rewrite feedback_claude_remote_default.md, reference_remo_code_connection.md; patch MEMORY.md, feedback_run_things_yourself.md, reference_deployment_infra.md; mark project_handoff_supervisor_ws_close.md STALE.
  • ~/.claude/CLAUDE.md: rewrite the "Remo Code" section to point at the MSI release and explicitly forbid suggesting the retired npm flow.

Verification

  • bun install clean after each workspace edit.
  • bun run build:web clean after every phase.
  • cd hub && bun test shows the same 5 pre-existing test-pollution failures that exist on origin/main (confirmed by running the suite against a clean origin/main worktree). All other tests pass: 311 pass / 67 skip.
  • cd hub && bun build src/index.ts --target=bun produces a clean bundle (no broken imports after channel deletion).
  • grep -rn "npx remo-code\|claude-remote" README.md CLAUDE.md web/src/ returns no results (only intentional retirement notices remain).

Inventory

.planning/phases/09-retire-npm-packages/INVENTORY.md — the original scope document.
.planning/phases/09-retire-npm-packages/PLAN.md — the per-phase execution plan.

Latest published npm versions (will be deprecated post-merge)

  • remo-code-agent@0.4.1
  • remo-code-supervisor@0.1.0

The Tauri MSI release at https://github.com/finedesignz/remo-code/releases/latest is the replacement.

🤖 Generated with Claude Code

@finedesignz
chore: delete agent/ workspace and publish-agent CI
2fecb5f 
Retire the remo-code-agent npm package. The Tauri supervisor desktop app
(MSI release) is the only supported local client now.

- Delete agent/ workspace (src, test, package.json, tsconfig).
- Drop "agent" from root workspaces.
- Delete .github/workflows/publish-agent.yml.

Hub /ws/agent route is unchanged — it stays as the WebSocket endpoint
the Tauri supervisor sidecar connects to.

Phase 09 plan: .planning/phases/09-retire-npm-packages/PLAN.md
@finedesignz
chore: drop supervisor npm publishing surface (keep Tauri sidecar)
8f83d52 
The remo-code-supervisor npm package is retired. supervisor/src/ stays
intact — the Tauri MSI build still compiles it as the sidecar binary.

- Delete supervisor/package.json and supervisor/README.md.
- Drop "supervisor" from root workspaces.
- Keep supervisor/src/ (Tauri sidecar source).
- Keep supervisor/tauri/ (Tauri project).
- Keep .github/workflows/release-supervisor.yml (Tauri MSI release).

Phase 09 plan: .planning/phases/09-retire-npm-packages/PLAN.md
@finedesignz
chore(hub): remove dead /ws/channel route and verifyChannelToken
4c6ea3f 
The channel WebSocket path was for the legacy claude-code-channel plugin
which is fully retired. The Tauri supervisor uses /ws/agent. /ws/client
is the browser path. /ws/channel had no remaining consumers.

- Delete hub/src/ws/channel.ts.
- Drop /ws/channel from the upgrade router, wsData dispatch, and the
  open/message/close handlers in hub/src/index.ts.
- Delete ChannelAuth, AssistantMessage, ChannelStatus, ChannelInbound
  Zod schemas from hub/src/ws/protocol.ts.
- Delete verifyChannelToken DAL helper from hub/src/db/dal.ts.

Hub builds clean, tests pass (same 5 pre-existing test-pollution failures
on origin/main, unrelated). Web build clean.

Phase 09 plan: .planning/phases/09-retire-npm-packages/PLAN.md
@finedesignz
docs+web: retire npm-package install paths, link Tauri MSI release
a04ba52 
Update every user-facing surface to point at the Tauri Supervisor MSI
release as the only supported local app.

Web UI:
- ConnectModal: rewrite as Tauri-MSI-only (drop npx remo-code-agent /
  npx remo-code-supervisor commands + claude-remote alias snippet).
- ApiKeyModal: drop the legacy agent <details> fallback block.
- SettingsPage: drop the legacy agent <details> fallback block.
- Sidebar: drop claude-remote wording from title tooltips.

Repo docs:
- README.md: rewrite Quick Start step 6 + Architecture + Project Structure
  to describe the Tauri Supervisor desktop app. Drop the shell-alias setup
  section and the hosted-version npx example.
- CLAUDE.md: rewrite Commands + Local Supervisor + WebSocket Protocol +
  Key Design Decisions to describe the supervisor instead of the agent.
  Drop the /ws/channel protocol entry.
- docs/agent.md: delete.

Planning + historical specs:
- .planning/codebase/*, .planning/STATE.md, .planning/ROADMAP.md,
  .planning/REQUIREMENTS.md, .planning/debug/cannot-connect-new-servers.md,
  several historical phase plans (04, 05, 06, 07, merge-self-heal):
  prepend a Phase 09 banner noting the retirement. Historical content
  is preserved.
- docs/superpowers/specs/2026-05-22-supervisor-remote-control-design.md
- docs/superpowers/specs/2026-03-28-streaming-agent-architecture-design.md
- docs/superpowers/plans/2026-03-28-streaming-agent-architecture.md
- docs/superpowers/plans/2026-04-27-migrate-supabase-to-postgres.md:
  same Phase 09 banner.

Web build clean. Hub tests unchanged from origin/main baseline.

Phase 09 plan: .planning/phases/09-retire-npm-packages/PLAN.md
@finedesignz finedesignz merged commit e10fa0c into main May 26, 2026
1 check passed
@finedesignz finedesignz deleted the chore/retire-npm-packages branch May 26, 2026 23:41
@finedesignz finedesignz mentioned this pull request May 26, 2026
Merged
finedesignz added a commit that referenced this pull request May 26, 2026
@finedesignz
fix(deploy): restore agent/supervisor package.json copy in Dockerfile (…
fda3d7d 
…#73)

agent/ directory was removed and supervisor/package.json no longer
exists after PR #72 retired the npm publication path. Workspaces
root only declares hub and web. Drop the stale COPY lines from
both build stages so the image builds.
@finedesignz finedesignz mentioned this pull request May 27, 2026
Merged
4 tasks
finedesignz added a commit that referenced this pull request May 27, 2026
@finedesignz @claude
chore(docs): clarify Tauri MSI install path + mark NSSM migration com…
7a3394d 
…plete (#87)

- README.md: install section now explicitly mentions HKCU Run-key
  auto-start (no Windows service, no shell alias) — clarifies the
  difference from the retired npx/NSSM flow.
- supervisor/MIGRATION.md: bump status from "In-progress" to "Completed
  2026-05-26 (Phase 09)" — the npm-package retirement landed in #72,
  and the agent/Dockerfile copy fix landed in #73, so the migration is
  fully closed.

Doc sweep verified the rest of the forward-looking surface
(README/CLAUDE/HANDOFF/docs/**/*.md) already references only the MSI
path. .planning/* historical archives left intact per phase-history
preservation policy; their Phase 09 retirement banners already mark
legacy `claude-remote` / `npx remo-code-agent` mentions as historical.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@finedesignz