What is Polygraph?

Polygraph is a standalone product for coordinating changes across multiple repositories. 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 into:

~/.agents/plugins/polygraph

installs the packaged custom Codex subagents into:

$CODEX_HOME/agents

updates the personal Codex marketplace at:

~/.agents/plugins/marketplace.json

so the polygraph plugin points at ./.agents/plugins/polygraph, 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 Stage Release workflow automatically tags the release and stages both dist/claude and dist/codex on npm. A maintainer must then review and approve each staged package with 2FA before it is published to the live registry.

Configure each npm package's trusted publisher to allow npm stage publish from .github/workflows/publish.yml. For the strictest release flow, do not allow direct npm publish for the trusted publisher and disallow token-based publishing after the staged workflow has been verified.

Learn More

• Polygraph — Multi-repo coordination with Polygraph
• 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.