polygraph-codex-plugin
v0.4.0
Published
AI agent skills and subagents for Polygraph multi-repo coordination
Downloads
945
Maintainers
Readme
What is Polygraph?
Polygraph coordinates changes across multiple repositories using Nx Cloud. It lets AI agents delegate work to child agents in other repos, monitor CI across repos, and manage multi-repo sessions.
Skills
- polygraph — Comprehensive guidance for multi-repo coordination: session init, delegation, branch pushing, PR creation, and session management
- await-polygraph-ci — Wait for CI pipelines to settle across all repos in a session, investigate failures, and present fix options
- get-latest-ci — One-shot fetch of the latest CI pipeline execution for the current branch
Agents
- polygraph-init-subagent — Discovers candidate repositories and initializes a Polygraph session
- polygraph-delegate-subagent — Delegates work to a child agent in another repository, polls for completion
Dist Layout
dist/claude— publishable Claude plugin npm package (polygraph-claude-plugin)dist/codex— publishable Codex plugin npm package (polygraph-codex-plugin)dist/opencode— generated OpenCode artifacts
Codex Installer
The publishable Codex package now exposes an explicit installer CLI:
npx polygraph-codex-pluginThat command copies the packaged Codex plugin into:
~/.agents/plugins/polygraphupdates the personal Codex marketplace at:
~/.agents/plugins/marketplace.jsonso the polygraph plugin points at ./.agents/plugins/polygraph, and enables the plugin in:
$CODEX_HOME/config.tomlCODEX_HOME defaults to ~/.codex when unset.
To verify an install, run:
npx polygraph-codex-plugin checkDevelopment
# Install dependencies
npm install
# Generate dist/ directly from source/
npm run sync-artifactsReleasing
Run the Release PR GitHub Actions workflow with a version bump (patch, minor, or major).
It opens a release PR against main instead of pushing directly.
When that PR is merged, the Publish workflow automatically tags the release and publishes both dist/claude and dist/codex to npm.
Learn More
- Nx Cloud Polygraph — Multi-repo coordination with Nx Cloud
- polygraph-mcp — The MCP server that powers Polygraph tools
- Nx AI Agent Skills — The main Nx AI agent skills repo
License
License information is defined in the package metadata.
