Contributing to Plexus

Thanks for helping make multi-agent configuration less repetitive.

Setup

npm ci
npm run dev

The dashboard runs at http://localhost:7777.

Before opening a PR, run:

npm run verify

For focused core work:

npm run test:core
npm run build --workspace=plexus-agent-config-core

For focused web work:

npm run build --workspace=plexus-agent-config-web

Do not commit secrets.
Do not write outside ~/.config/plexus/ without a backup path.
Use lstat before removing paths that may be symlinks.
Preserve agent-owned fields in shared native files such as ~/.claude.json and ~/.codex/config.toml.
Keep team config and personal config separate.

Good PRs include: