
One of the main goals of the ParrotSec team is to enable anyone to contribute, whether from a technical perspective or otherwise. The community represents one of our greatest strengths, if not the most important. This is why every contributor deserves recognition and everyone should be able to participate in development and/or propose new projects for inclusion in ParrotOS.

ParrotOS stands out for its wealth of ready-to-use tools for any task. Our ecosystem of metapackages is constantly expanding, and as innovation advances, new tools emerge with potentially useful features for specific purposes.

ParrotOS can serve as an ideal platform for publishing and distributing these tools, offering visibility and accessibility to the community.

Skip to [submit a tool proposal](https://gitlab.com/parrotsec/project/community#submit-a-tool-proposal).

## Proposal Process

We have received numerous requests via email to add new tools to our repository, developed by both individuals and teams. This document establishes a guided procedure to effectively manage this flow of requests, avoiding confusion and leveraging interest in Parrot.

This process is evolving and will be improved progressively.

## Criteria for adding new applications

To be considered for inclusion in Parrot, a new tool must:

- Serve a specific and well-defined purpose
- Not introduce structural changes to the system
- Pass evaluation by our team before being cloned to our GitLab profile and integrated into repositories

Since adding a tool makes it available to all users, each proposal will be carefully examined.

## Evaluation Timeline and Process

The time required for approval or rejection depends on various factors:

- Tool usefulness
- Complexity
- Security and stability
- Maintainability and compatibility with the existing ecosystem

And more. We commit to providing feedback in the shortest possible time.

## Managing proposals through issues

We use the issues and merge requests system to manage new proposals transparently since this mechanism allows us to:

- Track proposal status
- Communicate directly with developers
- Publicly document the decision-making process

Anyone with minimal experience with GitHub/GitLab knows that, especially in a FOSS project, problems can be reported through the issues mechanism. We want to use this same approach to manage new proposals, updating the status directly within the issue itself.

# Submit a tool proposal

Here is a step-by-step guide for users who want to propose a new tool:

1. Click on **Issues** tab
2. Select **New issue**
3. Add a title, the name of the tool you want to propose
4. Choose the template **new_tool** from the description section
5. Carefully complete **all** sections of the template by replacing the example text
6. Submit the issue
7. Stay available for any follow-up questions from our team and be ready to assist with packaging or integration if necessary

Once submitted, your proposal will be reviewed by the ParrotOS team. We'll evaluate it based on usefulness, security, compatibility, and how well it fits within our existing structure.

If any of the fields are redundant (e.g. the link to the project's website is the same as the link to the repository), it is not necessary to fill in both, just specify it and it will be handled directly in the issue discussion. Thank you!


Call for Tools