Skip to content

docs(amicode-patches): document how amicode consumes the fork (§5) #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jack-champagne merged 2 commits into from
Jul 28, 2026
Merged

docs(amicode-patches): document how amicode consumes the fork (§5) #15

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
496a88c
docs(amicode-patches): document how amicode consumes the fork (§5)
jack-champagne Jul 9, 2026
9c1683d
docs: correct pnpm filter to amicode (amicode-v2 does not exist)
jack-champagne Jul 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions AMICODE-PATCHES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,24 @@ PATH="$HOME/.bun/bin:$PATH" OPENCODE_VERSION=1.17.3 OPENCODE_CHANNEL=dev bun run
serve local app assets; only the compiled binary embeds them. (Env kill-switch:
`disableEmbeddedWebUi` → proxy mode.)

### 5. How amicode consumes this fork

amicode (`harmoniqs/amicode`, `packages/extension`) vendors a compiled binary of this fork; it
never runs it from source (per § 4, run-from-source proxies the public `app.opencode.ai`, so the
amicode-branded surfaces only exist in a compiled build).

- **Default = pinned release.** `opencode.lock.json` `source: release` → a plain `pnpm install`
downloads the pinned, gate-ON release asset. Teammates need no clone/bun. Changing this fork is
an explicit command, never a lock edit.
- **Iterate:** clone this fork beside amicode (`../opencode`), then from amicode run
`pnpm --filter amicode opencode:build` → invokes `script/build.ts` with `OPENCODE_CHANNEL=dev`
(gotcha 2) and re-vendors the binary. Reload the Extension Dev Host to pick it up.
- **Publish:** push a branch here, tag a release (the release workflow builds both targets with
`dev` and asserts the gate ON), then from amicode `pnpm --filter amicode opencode:pin <tag>`
to rewrite amicode's lock (downloads + sha256-verifies both assets).
- amicode's `packages/extension/scripts/assert_ui_gate.sh` reds CI/release if any vendored binary
ships with the gate OFF — the automated form of gotcha 2's grep.

## Branding map (v1.17.3)

User-visible brand sites in the served web app (packages/app + packages/ui), enumerated at tag v1.17.3.
Expand Down
Loading