Skip to content

[codex] Document source startup requirements#39

Merged
hetaoBackend merged 1 commit into
mainfrom
codex/startup-docs-bun-path
Jul 2, 2026
Merged

[codex] Document source startup requirements#39
hetaoBackend merged 1 commit into
mainfrom
codex/startup-docs-bun-path

Conversation

@hetaoBackend

Copy link
Copy Markdown
Owner

What changed

  • Updated the English and Chinese README source-start instructions to install both backend/ and taskboard-electron/ dependencies.
  • Documented that Bun must be available on PATH and that the desktop app owns the 127.0.0.1:9712 backend.
  • Expanded installation troubleshooting for bun: command not found, missing backend dependencies, port conflicts, clean installs, and verification.
  • Updated keep_running.sh so non-interactive bash sessions can find Bun installed under ~/.bun/bin.

Why

A fresh source checkout can fail to start if only the desktop package dependencies are installed, because the Electrobun host imports backend TypeScript directly. Some local shells also had Bun installed but not exposed through PATH, which made bun run start fail.

Validation

  • git diff --check
  • bash -n keep_running.sh

@vercel

vercel Bot commented Jul 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agentforge-landing Ready Ready Preview, Comment Jul 2, 2026 2:58am

@hetaoBackend hetaoBackend marked this pull request as ready for review July 2, 2026 09:23
@hetaoBackend hetaoBackend merged commit db33f92 into main Jul 2, 2026
4 checks passed
@hetaoBackend hetaoBackend deleted the codex/startup-docs-bun-path branch July 2, 2026 09:24
hetaoBackend added a commit that referenced this pull request Jul 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant