PrintHive

Print Hive for Codex

The official Print Hive plugin gives Codex organization-scoped tools and workflows for printers, jobs, queues, models, files, filament, inventory, and Makes. The plugin connects to Print Hive through OAuth; it does not store printer access codes in your repository.

Prerequisites

  • A current Codex CLI or Codex desktop installation
  • A Print Hive account with access to the organization you want to manage
  • HiveLink online for any printer you want to inspect or control

Install from the official marketplace

codex plugin marketplace add PrintHive/print-hive-plugins
codex plugin add print-hive@print-hive

The marketplace is published from PrintHive/print-hive-plugins. Inspect the repository or latest release before installing if your organization requires source review.

Authorize Print Hive

  1. Start Codex with codex, then open /plugins and confirm Print Hive is installed and enabled.
  2. Start a new thread so the plugin and bundled MCP configuration are loaded.
  3. Open /mcp or use a Print Hive workflow. When prompted, sign in through Print Hive OAuth.
  4. Review the requested permissions, select the correct Print Hive organization, and approve the connection.

Verify the installation

codex plugin list

In a new Codex thread, open /mcp and confirm that print-hive is connected. Start with a read-only prompt:

List my printers and separate connectivity from print activity.

Update or remove

codex plugin marketplace upgrade print-hive
codex plugin remove print-hive@print-hive

Start a new thread after upgrading so Codex loads the refreshed plugin snapshot.

Security boundaries

  • OAuth access is bound to your selected Print Hive organization and granted scopes.
  • Printer access codes and local host credentials are entered only in the Print Hive web app.
  • Write and printer-control tools resolve an explicit target and may require confirmation before execution.
  • Raw G-code, direct temperature control, and emergency actions are not implicitly granted by the plugin's OAuth connection.

Troubleshooting

  • Plugin is missing — run codex plugin marketplace list, refresh the print-hive marketplace, and open /plugins again.
  • OAuth is disconnected — open /mcp in a new thread and reconnect Print Hive.
  • Printer is offline — verify HiveLink and network health before retrying a control action.