vrr/CodeNomad
2
0
Fork 0
mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-08-23 15:23:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
CodeNomad/packages/opencode-plugin
History
Exact
Shantur Rathore f6fd8c9fca test(github): cover webhook job runner 
Restore the fuller GitHub bot operating guidance so headless runs have clear workflow, continuation, and scope instructions for issue comments, PR openings, and review-comment events.

Add runner-level coverage around accepted issue-comment dispatch and same-thread supersession. The job runner now accepts a narrow operations seam so tests can exercise workspace setup, worktree context, OpenCode command arguments, and abort behavior without real GitHub, git, or OpenCode services.

Update the server test script to discover nested __tests__ files and unref delayed workspace cleanup timers so test and short-lived process exits are not held open by background cleanup scheduling.

Validation: npm run test --workspace @neuralnomads/codenomad; npm run typecheck --workspace @neuralnomads/codenomad; npm run build --workspace @codenomad/codenomad-opencode-plugin; git diff --check.
2026-08-13 16:29:18 +01:00
..
plugin test(github): cover webhook job runner 2026-08-13 16:29:18 +01:00
package.json Bump version to 0.19.0 2026-08-13 09:39:25 +01:00
README.md Package CodeNomad OpenCode plugin (#433) 2026-05-12 09:00:22 +01:00
tsconfig.json Package CodeNomad OpenCode plugin (#433) 2026-05-12 09:00:22 +01:00

README.md

CodeNomad OpenCode Plugin

TLDR

Packaged OpenCode plugin injected into every OpenCode instance that CodeNomad launches. It provides the CodeNomad bridge for local event exchange between the CLI server and OpenCode.

What it is

An npm-packable plugin package. Production builds ship a local .tgz and inject it through OPENCODE_CONFIG_CONTENT; dev runs reference the TypeScript plugin entry directly with a file:// URL.

How it works

  • CodeNomad sets OPENCODE_CONFIG_CONTENT when spawning each OpenCode instance (packages/server/src/workspaces/manager.ts).
  • The server packs this package during build (packages/server/scripts/package-opencode-plugin.mjs).
  • OpenCode loads the plugin from plugin entries injected into the config content.
  • The CodeNomadPlugin reads CODENOMAD_INSTANCE_ID + CODENOMAD_BASE_URL, connects to GET /workspaces/:id/plugin/events, and posts to POST /workspaces/:id/plugin/event (packages/opencode-plugin/plugin/lib/client.ts).
  • The server exposes the plugin routes and maps events into the UI SSE pipeline (packages/server/src/server/routes/plugin.ts, packages/server/src/plugins/handlers.ts).

Expectations

  • Local-only bridge (no auth/token yet).
  • Plugin must fail startup if it cannot connect after 3 retries.
  • Keep plugin entrypoints thin; put shared logic under plugin/lib/ to avoid autoloaded helpers.
  • Keep event shapes small and explicit; use type + properties only.

Ideas

  • Add feature modules under plugin/lib/features/ (tool lifecycle, permission prompts, custom commands).
  • Expand /workspaces/:id/plugin/* with dedicated endpoints as needed.
  • Promote stable event shapes and version tags once the protocol settles.

Pointers

  • Plugin entry: packages/opencode-plugin/plugin/codenomad.ts
  • Plugin client: packages/opencode-plugin/plugin/lib/client.ts
  • Plugin server routes: packages/server/src/server/routes/plugin.ts
  • Plugin event handling: packages/server/src/plugins/handlers.ts
  • Workspace env injection: packages/server/src/workspaces/manager.ts