Skip to content

docs: add phux agent CLI page#4

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/683ba3c5
Open

docs: add phux agent CLI page#4
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/683ba3c5

Conversation

@mintlify
Copy link
Copy Markdown

@mintlify mintlify Bot commented May 31, 2026

Summary

Documents the new structured CLI surface that lets AI agents and scripts drive phux terminals without a TTY.

Changes

  • New phux/agent-cli.mdx page covering the ls, new, snapshot, send-keys, run, and wait verbs.
  • Documents the selector grammar, the read-act-wait loop, JSON shapes (SessionListJson, ScreenState, RunResult), and the per-verb exit-code table.
  • Adds a "Consumers" group to the phux tab in docs.json navigation.

Context

The upstream PR introduces a stable, side-effect-free agent CLI: each verb returns versioned JSON with --json, reads do not attach or resize the target pane, and phux run mirrors child exit codes so it composes with shell chains. This is the largest user-facing addition in the PR — the other new docs (concepts, config schema, architecture diagram, protocol tutorial) are contributor-facing or describe behavior already covered in the existing introduction and protocol pages.

@mintlify
Copy link
Copy Markdown
Author

mintlify Bot commented May 31, 2026

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

Project Status Preview Updated (UTC)
phall 🟢 Ready View Preview May 31, 2026, 4:42 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants