Some contrib packages for the bub ecosystem.

You can find a broader plugin catalog at hub.bub.build, which includes packages maintained in this repository as well as third-party Bub plugins.

If you have developed a plugin, you can also choose to register it in bubbuild/buildscape instead of submitting all of its source code to this repository.

Below is the list of packages currently included in this repository.

Packages In This Repository

Package	PyPI Status	Description
packages/bub-codex		Provides a run_model hook that delegates model execution to the Codex CLI.
packages/bub-cursor		Provides a run_model hook that delegates model execution to the Cursor CLI, plus bub login cursor.
packages/bub-acp-server		Exposes Bub as an Agent Client Protocol agent with bub acp serve for ACP-compatible editors.
packages/bub-schedule		Provides scheduling channel/tools backed by APScheduler with a JSON job store.
packages/bub-tapestore-otel		Wraps the active tape store and projects committed tape writes to OpenTelemetry through Logfire.
packages/bub-tapestore-sqlalchemy		Provides a SQLAlchemy-backed tape store for Bub conversation history.
packages/bub-tapestore-sqlite		Provides a SQLite-backed tape store for Bub conversation history.
packages/bub-discord		Provides a Discord channel adapter for Bub message IO.
packages/bub-dingtalk		Provides a DingTalk Stream Mode channel adapter for Bub message IO.
packages/bub-extism		Bridges selected Bub hooks to Extism WebAssembly plugins so extensions can be written in any Extism PDK language.
packages/bub-github-copilot		Provides a run_model hook backed by the GitHub Copilot SDK, plus bub login github device-flow login commands.
packages/bub-kimi		Provides a run_model hook backed by the Kimi CLI, including persisted session resume support and temporary Bub skill wiring.
packages/bub-mcp		Exposes configured MCP servers as Bub tools, with bub mcp CLI commands to list, add, and remove server configs.
packages/bub-mcp-server		Exposes Bub as an SSE MCP server with a run_model tool.
packages/bub-qq		Provides a QQ Open Platform channel adapter for Bub message IO.
packages/bub-web-search		Provides provider-selectable Ollama (web.search) and SearXNG (searxng.search) tools, enabling only the configured search provider.
packages/bub-feishu		Provides a Feishu channel adapter for Bub message IO.
packages/bub-session-prompt		Provides a session-specific system prompt sourced from ~/.bub/sessions/<session_id>/AGENTS.md.
packages/tape-dataset-opendal		Exports standard Bub/Republic tapes to a backend-agnostic dataset layout through OpenDAL, with CEL filtering and staged share-review support.
packages/bub-wechat		Provides a WeChat channel adapter for Bub message IO.
packages/bub-wecom		Provides a WeCom channel adapter for Bub message IO.

• Python 3.12+ (workspace root)
• uv (recommended)

To install an individual package, run:

bub install <package-name>@main

Install all workspace dependencies:

uv sync

We encourage all plugin contributors to take responsibility for the ongoing maintenance of their submitted plugins. Each plugin should ideally have at least one active maintainer who is familiar with its domain and willing to respond to issues or update dependencies as needed.

To foster a healthy and growing ecosystem, the code review standards for contributed plugins will be appropriately relaxed compared to core Bub repositories. We prioritize:

• Practicality and usefulness over strict style or architectural perfection
• Clear ownership: contributors are expected to respond to issues and PRs related to their plugins
• Basic safety and compatibility: plugins should not break the workspace or introduce security risks

We welcome experimental, niche, or work-in-progress plugins, as long as they are clearly documented and do not negatively impact other packages in this repository.

If you are submitting a plugin, please be prepared to maintain it or help find a new maintainer if you become unavailable.

This repository is licensed under LICENSE.