Contributing¶

Contributions are welcome. If you found a bug, have an idea for a new agent, or want to improve something, the process is simple.

Before submitting a PR¶

Open an issue first to discuss what you want to change. This avoids wasted work on both sides, especially for larger changes.

Local setup¶

git clone https://github.com/sandeco/reversa.git
cd reversa
npm install

Project structure¶

reversa/
├── agents/             ← each agent has its folder with SKILL.md
├── bin/                ← CLI entry point (reversa.js)
├── lib/
│   ├── commands/       ← CLI command implementations
│   └── installer/      ← installation and engine detection logic
├── templates/          ← config templates and engine entry files
└── docs/               ← documentation (you are here)

Adding a new agent¶

Create the folder agents/reversa-[name]/
Create SKILL.md following the format of existing agents (required frontmatter: name, description, license, compatibility, metadata)
Add a references/ folder if the agent needs schema or reference templates
Update lib/installer/ to include the new agent in the install list

License¶

MIT. See LICENSE for details.