Skip to content

docs: CLI ships with pipecat-ai; rename init→create + document agent-ready init#869

Open
markbackman wants to merge 5 commits into
mainfrom
mb/pipecat-ai-cli-port
Open

docs: CLI ships with pipecat-ai; rename init→create + document agent-ready init#869
markbackman wants to merge 5 commits into
mainfrom
mb/pipecat-ai-cli-port

Conversation

@markbackman

@markbackman markbackman commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Aligns the docs with the CLI changes shipping in pipecat-ai 1.4.0 (pipecat-ai/pipecat#4710): the CLI now ships with pipecat-ai as the optional [cli] extra, the scaffolder is renamed initcreate, and pipecat init is repurposed to make a project agent-ready.

Hold until pipecat-ai 1.4.0 ships with the CLI.

Packaging

  • Install via uv tool install "pipecat-ai[cli]" across the quickstarts, build-your-next-bot, and Gemini Live.
  • cloud co-installs as a plugin via --with pipecatcloud.
  • Pipecat Cloud: fix the CI install examples (PATs guide) and add an "Install the CLI" step to the introduction. (The deploy GitHub Action is API-key based and untouched.)

CLI rename: initcreate, plus the new init

  • New api-reference/cli/create.mdx — the scaffolder reference (former init.mdx content), now with --eval and pipecat create quickstart.
  • api-reference/cli/init.mdx rewritten for the new agent-ready command: writes AGENTS.md / CLAUDE.md / GETTING_STARTED.md, takes [TARGET_DIR] + --force, never clobbers an existing CLAUDE.md, stamps a provenance footer, and redirects to create if scaffolder flags are passed.
  • docs.json nav: add create.
  • cli/overview.mdx: list both commands; point the scaffold card/links at create.
  • Swept scaffolder invocations to create: quickstart, examples overview, Gemini Live, cloud-builds, client quickstart.

Discoverability / agent flow

  • build-your-next-bot.mdx: leads with the recommended agent flow (pipecat init → open a coding session → the agent scaffolds via pipecat create), keeping the direct pipecat create path below.
  • ai-tools.mdx: new "Make your project agent-ready (pipecat init)" lead section that pairs with the Context Hub; intro now covers agent setup, not just context; the existing CLAUDE.md section is clarified as the framework repo's file (distinct from the one init writes into your project).

Tail removal

  • Removes the pipecat tail subcommand docs: delete api-reference/cli/tail.mdx, drop it from the nav and the CLI overview. (The standalone Tail tool keeps its own repo; only the CLI subcommand docs are removed.)

@mintlify

mintlify Bot commented Jun 4, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
daily 🟢 Ready View Preview Jun 4, 2026, 2:57 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

Copy link
Copy Markdown
Contributor

Broken links detected!

Please check the workflow logs for details on which links are broken and fix them before merging.

The pipecat init CLI now ships with pipecat-ai as the optional [cli] extra,
and pipecatcloud / pipecat-ai-tail are co-installed plugins.

- Swap install commands to \`uv tool install "pipecat-ai[cli]"\` across the
  quickstarts, build-your-next-bot, and the Gemini Live quickstart.
- Reframe the CLI overview: init is built in; cloud/tail co-install via
  \`--with pipecatcloud\` / \`--with pipecat-ai-tail\`.
- Fix the Tail page install + observer wiring (pipecat-ai-tail /
  \`from pipecat_tail.observer import TailObserver\`).
- Pipecat Cloud: fix the CI install examples (PATs guide) and add an
  "Install the CLI" step to the introduction. The deploy GitHub Action is
  API-key based and untouched.

Hold until pipecat-ai 1.4.0 ships with the CLI.
PR #4710 (pipecat-ai 1.4.0) renames the scaffolder `pipecat init` ->
`pipecat create` and repurposes `pipecat init` to make a project
agent-ready (writes AGENTS.md/CLAUDE.md/GETTING_STARTED.md). Align the
docs with that CLI:

- New api-reference/cli/create.mdx carries the scaffolder reference
  (the former init.mdx content); init.mdx is rewritten for the new
  agent-ready command. docs.json nav adds create.
- CLI overview lists both commands and points scaffold links at create.
- Build Your Next Bot leads with the recommended agent flow
  (`pipecat init` -> coding session -> agent scaffolds via
  `pipecat create`), keeping the direct `pipecat create` path.
- Sweep scaffolder invocations to `create` in quickstart, examples,
  gemini-live, cloud-builds, and the client quickstart.

Builds on 04d011d (the pipecat-ai[cli] package move). Hold until 1.4.0.
@markbackman markbackman force-pushed the mb/pipecat-ai-cli-port branch from 61504cb to 470709f Compare June 13, 2026 19:49
@github-actions

Copy link
Copy Markdown
Contributor

Broken links detected!

Please check the workflow logs for details on which links are broken and fix them before merging.

…E.md

The AI-Assisted Development page covered the Context Hub but never
mentioned `pipecat init`. Add a lead section: run `pipecat init` to make
a project agent-ready (writes AGENTS.md/CLAUDE.md/GETTING_STARTED.md),
pairing with the Context Hub for live context, and link Build Your Next
Bot. Clarify that the existing CLAUDE.md section is the framework repo's
own file, distinct from the one init writes into your project.
main removed the `pipecat tail` subcommand (page + nav); the rebase
replayed this branch's overview edits, which still referenced it. Remove
the Monitor card, the tail co-install, command entry, and --help line so
the overview matches the shipped CLI and has no dead links.
@markbackman markbackman force-pushed the mb/pipecat-ai-cli-port branch from 04c4bf2 to b42ea16 Compare June 13, 2026 19:56
@markbackman markbackman changed the title Update docs for the CLI shipping with pipecat-ai docs: CLI ships with pipecat-ai; rename init→create + document agent-ready init Jun 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant