Skip to content

feat: add bare-metal runner — run straight from GitHub#320

Open
jelloeater-agent wants to merge 2 commits into
chriswritescode-dev:mainfrom
jelloeater-agent:feat/npx-runner
Open

feat: add bare-metal runner — run straight from GitHub#320
jelloeater-agent wants to merge 2 commits into
chriswritescode-dev:mainfrom
jelloeater-agent:feat/npx-runner

Conversation

@jelloeater-agent

@jelloeater-agent jelloeater-agent commented Jul 24, 2026

Copy link
Copy Markdown

What

Run OpenCode Manager with one command — no clone, no Docker, no npm publish:

# Straight from GitHub (like uvx git+https://...)
bunx github:chriswritescode-dev/opencode-manager

# From npm (after publish)
bunx opencode-manager

# From a local clone
git clone https://github.com/chriswritescode-dev/opencode-manager.git && ./bin/opencode-manager

How

The CLI bootstraps the full service on first run:

  • Checks/install prerequisites (Bun, Git, OpenCode)
  • Creates data directory at ~/.opencode-manager/
  • Auto-generates AUTH_SECRET on first run
  • Installs dependencies and builds frontend
  • Starts the backend server on :5003

Edit ~/.opencode-manager/.env to customize ports, auth, etc.

Files

File Purpose
bin/opencode-manager Shell entry point — finds bun, delegates to TS
bin/opencode-manager.ts Bun bootstrapper — prereqs, setup, start
scripts/build-npm.ts prepack hook — builds frontend for publish
package.json Added bin, files, prepack fields
README.md Added GitHub/npm/clone quick-start sections

Why

Docker and clone-and-configure are friction. bunx github:... should be the fastest path from zero to running.

Adds a one-liner entry point so OpenCode Manager can be started
without Docker or cloning the repo:

  bunx opencode-manager

The CLI bootstraps the full service:
- Checks/install prerequisites (Bun, Git, OpenCode)
- Creates data directory at ~/.opencode-manager/
- Auto-generates AUTH_SECRET on first run
- Installs dependencies and builds frontend
- Starts the backend server

Also adds:
- bin/ entry point (shell + Bun TypeScript)
- scripts/build-npm.ts prepublish hook
- package.json bin/files/prepack fields
- README one-liner quick-start section
@jelloeater-agent jelloeater-agent changed the title feat: add bare-metal runner via bunx feat: add bare-metal runner — run straight from GitHub Jul 24, 2026
@Jelloeater

Copy link
Copy Markdown

@chriswritescode-dev Hope this helps 👍🏻

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.

2 participants