README Studio section still documents the old npx serve launcher

Open Beginner friendly
#35 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 6 days

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
84/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript
Domain
documentation

Research direction

The outdated instructions are at README.md lines 237-238. Read docs/studio-v2-architecture.md around line 40, then install.sh near line 658 and scripts/studio-service.sh to confirm the orchestra-studio command and port 3110. Done when the README Studio section describes orchestra-studio on port 3110 and the npx serve commands are removed or marked as legacy.

Written by the indexing model from the issue text.

Description

documentation good first issue priority: low

Context

The README Studio section tells users to run npx serve on the built dist, but the Studio v2 architecture doc says that launcher was replaced by server/studio-api.js launched via orchestra-studio.

Evidence

  • README.md:237-238: npx serve -l 0 ~/.config/opencode/studio/dist / Cursor variant.
  • docs/studio-v2-architecture.md:40: "replacing the old npx serve static launcher".
  • install.sh:658 launcher shim delegates to scripts/studio-service.sh.
  • Related: see the Cursor studio dist path issue.

Acceptance criteria

  • README Studio section describes orchestra-studio and port 3110.
  • Remove or mark the npx serve instructions as legacy.

Found during the v3.8.0 audit (tag v3.8.0, commit 22d2146). Paths/lines are at that commit.

Dominant language
JavaScript
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from P-Core-System/pcore-orchestra

All issues in P-Core-System/pcore-orchestra

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.