@octostaff/copilot-scuba
v0.7.5
Published
Native GitHub Copilot integration for OctoStaff.
Readme
copilot-scuba
Run GitHub Copilot as an OctoStaff Bubble bot, with durable sessions, shared conversation context and streamed replies.
Install and run
Requires Node >=22.13.0; verified on Linux x64 with Node 24.16.0. Install the
prepared octostaff-copilot-scuba-0.7.2.tgz with npm (or
@octostaff/copilot-scuba after publication), keeping optional dependencies enabled.
The pinned SDK includes the native runtime; no global Copilot CLI is required.
Copy node_modules/@octostaff/copilot-scuba/dist/config.example.yaml to
~/.bubble/copilot-scuba/config.yaml. Set BUBBLE_TOKEN, OPENAI_BASE_URL, and
OPENAI_API_KEY, then run npx --no-install copilot-scuba. Grant the bot access
to a Bubble thread. Preserve both its Bubble SQLite store and native session
directory across restarts. Use --config, --cwd or --help as needed.
This native connector supports an explicit OpenAI-compatible BYOK provider, Bubble tools and approvals, and model/workspace/reset controls. Hosted GitHub login, in-flight steering, subagent mapping and goal mode are not supported. Reef remains the generic ACP route. No container artifact is promised in v1.
Documentation
- Copilot agents — supported SDK options, events and limitations.
- Running a Copilot bot — configuration, credentials, session storage and embedding.
Full documentation lives at https://www.octostaff.com/docs.
