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

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

OpenCode Plugin

The publishable OpenCode package exposes the skills and subagents through OpenCode's native plugin system. Add it to opencode.json:

{
  "plugin": ["polygraph-opencode-plugin"]
}

For repeatable installs, pin the npm version:

{
  "plugin": ["[email protected]"]
}

The plugin adds its packaged skills/ directory to OpenCode's skill paths and registers the packaged Markdown agents as subagent entries in OpenCode config during startup.

Development

# Install dependencies
npm install

# Regenerate generated artifacts
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 publishes the Claude, Codex, and OpenCode npm packages. 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.