codex-flows/docs/pages/reference/packages.md

title	description
Packages	Public and workspace packages in the codex-flow stack.

Packages

@peezy.tech/codex-flows

Low-level Codex app-server client package. It exports:

• app-server JSON-RPC client and stdio/WebSocket transports
• browser-safe gateway client and gateway protocol server primitives
• browser-safe WebSocket transport
• framework-agnostic app-server flow helpers
• auth helpers for account login/status/usage
• workbench reducers and request descriptors
• generated Codex app-server protocol types

@peezy.tech/flow-runtime

Runtime package for:

• loading flow.toml
• discovering .codex/flows/* before flows/*
• matching events with trigger type and JSON Schema
• running Bun and gated Code Mode steps
• local and HTTP flow clients
• backend response normalization

@peezy.tech/flow-backend-convex

Convex component for generic flow control-plane state: manifests, events, runs, attempts, leases, output chunks, and final result payloads.

Workspace apps

• codex-flow-runner: local CLI for listing, firing, and running steps.
• codex-flow-systemd-local: local durable HTTP backend and CLI.
• codex-discord-bridge: Discord-to-Codex bridge with gateway delegation and read-only flow inspection tools.
• codex-gateway-local: local WebSocket gateway that forwards native app-server calls and exposes gateway-owned events/commands.
• web: browser UI for Codex threads through the local gateway.
• codex-app-cli: JSON-RPC CLI for app-server actions.