Xpert

xpert (codex-packx-expert)

A Bun/TypeScript CLI that orchestrates **packx → Codex expert agents** to produce:

1. An expert-friendly, copy/paste-ready markdown bundle in .xpert/bundles/.md
2. A single expert instruction file in .xpert/plans/.md

Designed for use from tools like Claude Code (clean stdout, progress on stderr).

Requirements

• bun installed
• codex installed + authenticated (codex login)
• packx installed (used by the bundle stage)

Install

bun install
bun link    # Installs globally as `xpert`

Commands

All commands available as `xpert ` or `xpert-`:

Doctor

xpert doctor

Checks for `codex`, `packx`, and authentication.

Bundle only

xpert bundle "Review the notes window focus logic"
# or stdin
cat prompt.md | xpert bundle -

Output:

OUTPUT_FILE_PATH: .xpert/bundles/.md

Add `--dump` to print the whole bundle to stdout for copy/paste.

Expert only (from an existing bundle)

xpert expert --bundle .xpert/bundles/.md ""

End-to-end (bundle → expert)

xpert solve "Review the notes window focus logic"

Output:

OUTPUT_FILE_PATH: .xpert/plans/.md

Add `--dump` to print the full expert instructions markdown.

Options

--cd             Workspace root (default: .)
--name         Output name (default: derived from request)
--model        Codex model override
--dump                Print generated markdown to stdout
--dump-only           Print markdown only (no OUTPUT_FILE_PATH line)
--raw-limit        packx token cap (default: 47000)
--concurrency      Scout concurrency (default: 2)
--iterations       Audit/revision passes (default: 2)
--no-search           Disable web search for docs-researcher

Safety defaults

• Workspace-write sandbox: Codex can write to the workspace (required for bundle output)
• AGENTS.md disabled: Local project