Polygraph Skills

AI agent skills and subagents for Polygraph multi-repo coordination. The build writes publishable package roots into dist/.

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-plugin

That command copies the packaged Codex plugin payload into:

$CODEX_HOME/plugins/cache/polygraph/polygraph/<version>

and enables the plugin in:

$CODEX_HOME/config.toml

CODEX_HOME defaults to ~/.codex when unset.

To verify an install, run:

npx polygraph-codex-plugin check

Development

# Install dependencies
npm install

# Generate dist/ directly from source/
npm run sync-artifacts

Releasing

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.