Toolchain mismatch
Use Node 20.11.0 and pnpm 9.15.5 to match the pinned versions in package.json.
Documentation
Zeo is a governance and evidence-mapping platform for decisions under uncertainty. The CLI handles policy and analysis workflows, while this site provides static-first onboarding, docs, and support paths.
- Deterministic policy evaluation and audit-friendly evidence bundles.
- CLI and web flows for governance checks, replay analysis, and provenance review.
- GitHub integration options for checks and webhook processing.
Install
Set up dependencies and build the workspace.
Quickstart
Run Zeo locally in web and CLI modes.
GitHub Connection
Configure app permissions and secure webhooks.
Most used commands
pnpm install pnpm -r build pnpm doctor pnpm -C apps/web dev
Troubleshooting
Missing environment variables
Copy .env.example to .env and only add the integrations you need for your local run.
Webhook signature mismatch
Confirm the same GITHUB_WEBHOOK_SECRET is used by GitHub and your local Zeo runtime.
Permissions errors
Re-run install, confirm write access in your workspace, and execute pnpm doctor for targeted diagnostics.
Ready to run Zeo?
Use quickstart for the fastest local validation path, then connect GitHub for policy-aware workflows.