Package Stack

OpenMarketing is built on the Pi runtime and uses curated Pi packages for evidence gathering, durable context, delegation, scheduling, preview, and long-running work. Packages are managed through openmarketing packages commands and configured in ~/.openmarketing/agent/settings.json.

Core packages

These are installed by default with every OpenMarketing installation. The list matches CORE_PACKAGE_SOURCES in src/pi/package-presets.ts.

PackagePurpose
@companion-ai/alpha-hubalphaXiv access, carried over from Feynman. Login state lives in ~/.ahub
pi-subagentsDispatch bundled marketing specialists and independent verification passes
pi-btwFast side-thread /btw conversations without interrupting the main workflow
pi-docparserParse PDFs, Office documents, spreadsheets, and images for content extraction
pi-web-accessWeb search, browsing, GitHub access, PDF fetching, and media retrieval
pi-markdown-previewRender Markdown artifacts as HTML or PDF (/preview)
@walterra/pi-chartsGenerate charts and quantitative visualizations from data
pi-mermaidRender Mermaid diagrams in the terminal UI
@aliou/pi-processesManage long-running jobs, background tasks, and log tailing
pi-zoteroRetrieve evidence from a configured Zotero library
pi-schedule-promptSchedule explicitly approved recurring work designed through /loop
@samfp/pi-memoryPreference and correction memory across sessions
@tmustier/pi-ralph-wiggumBounded iterative agent runs for long-running work

@samfp/pi-memory contains native code. On Node majors newer than 24 it is left out automatically.

These packages are updated together when you run openmarketing update. You do not need to install them individually.

@kaiserlich-dev/pi-session-search is no longer bundled. It crashes the agent process on Pi 1.x after a session switch, so OpenMarketing removes it from existing configurations on launch. Session history is native in Pi and in the desktop app. See Session Search.

Optional packages

Install on demand with openmarketing packages install <preset>.

PackagePresetPurpose
pi-generative-uigenerative-ui (alias ui)Interactive Glimpse UI widgets. macOS only

all-extras installs every optional preset available on your platform.

Installing and managing packages

List all available packages and their install status:

openmarketing packages list

Install a specific optional preset:

openmarketing packages install generative-ui

On Linux and Windows, generative-ui is hidden from openmarketing packages list and explicit installs print a platform message instead of attempting an npm install. In the standalone macOS bundle the preset is also unavailable, because its native dependency does not compile reliably there; install OpenMarketing through npm if you need it.

Updating packages

Update all installed packages to their latest versions:

openmarketing update

Update a specific package:

openmarketing update pi-subagents

Running openmarketing update without arguments updates everything. Pass a specific package name to update just that one. Updates preserve your configuration.

This command updates Pi packages inside OpenMarketing’s environment. To upgrade the standalone OpenMarketing app itself, rerun the installer from the Installation guide.