Contributing to Warp
# Contributing to Warp Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). ## Ways you can contribute * **Report a bug or request a feature** - [File an issue](https://github.com/warpdotdev/warp/issues/new/choose) in [`warpdotdev/warp`](https://github.com/warpdotdev/warp), or [explore existing issues](https://github.com/warpdotdev/warp/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) to comment on or upvote ones that matter to you. Clear reproductions and upvotes help Warp prioritize. * **Contribute code** - Claim any issue labeled `ready-to-spec` or `ready-to-implement`, then open a spec or code PR. [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md) covers the spec format, tests, `./script/presubmit`, and the PR template. * **Build a theme** - Submit a new color scheme or improve an existing one at [`warpdotdev/themes`](https://github.com/warpdotdev/themes). * **Share a workflow** - Add reusable command patterns to [`warpdotdev/workflows`](https://github.com/warpdotdev/workflows). Merged workflows ship to every Warp user. * **Publish Warp Drive objects** - Share Workflows, Notebooks, Rules, and Prompts publicly from [Warp Drive](/knowledge-and-collaboration/warp-drive/). * **Find an issue to pick up** - Browse [`build.warp.dev`](https://build.warp.dev), a live dashboard of the work Warp's agents are tackling across `warpdotdev/warp`. Use it to spot gaps, avoid duplicate work, and surface issues that haven't been claimed yet. * **Help others in the community** - Answer questions in the [Warp community Slack](https://go.warp.dev/join-preview) or [Discord](https://discord.com/invite/warpdotdev), and join conversations in [GitHub Discussions](https://github.com/warpdotdev/warp/discussions). ## Send feedback and bug reports The fastest way to file a bug or feature request is the [`/feedback`](/support-and-community/troubleshooting-and-support/sending-us-feedback/#using-feedback-in-warp) slash command inside Warp. It drafts and files a GitHub issue without leaving the terminal. Other channels: * File an issue directly in [`warpdotdev/warp`](https://github.com/warpdotdev/warp/issues/new/choose). * Press `⌘+Shift+F` (macOS) or `Ctrl+Shift+F` (Windows/Linux) to open the in-app feedback dialog. On macOS, you can also use the **Send Feedback** option in Warp's Help menu. * Email [privacy@warp.dev](mailto:privacy@warp.dev) for privacy questions. For logs, crash reports, CPU samples, and AI debugging IDs, see [Sending feedback and logs](/support-and-community/troubleshooting-and-support/sending-us-feedback/). ## Reporting security issues :::danger Do not file public issues for security vulnerabilities. ::: Email [security@warp.dev](mailto:security@warp.dev) with reproduction steps, impact, and any proof of concept. We'll acknowledge receipt and coordinate a fix and disclosure. Full guidance is in [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md#reporting-security-issues). ## Code of conduct Warp's open source repositories follow the [Contributor Covenant](https://www.contributor-covenant.org/) v2.1. Read the [full text](https://github.com/warpdotdev/warp/blob/master/CODE_OF_CONDUCT.md), or report violations to [warp-coc@warp.dev](mailto:warp-coc@warp.dev).Contribute to Warp's open source client by filing issues, opening pull requests, building themes, sharing workflows, and publishing Warp Drive objects to the community.
Warp’s client is open source under AGPL v3 at warpdotdev/warp, and there’s room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see CONTRIBUTING.md.
Ways you can contribute
Section titled “Ways you can contribute”- Report a bug or request a feature - File an issue in
warpdotdev/warp, or explore existing issues to comment on or upvote ones that matter to you. Clear reproductions and upvotes help Warp prioritize. - Contribute code - Claim any issue labeled
ready-to-specorready-to-implement, then open a spec or code PR.CONTRIBUTING.mdcovers the spec format, tests,./script/presubmit, and the PR template. - Build a theme - Submit a new color scheme or improve an existing one at
warpdotdev/themes. - Share a workflow - Add reusable command patterns to
warpdotdev/workflows. Merged workflows ship to every Warp user. - Publish Warp Drive objects - Share Workflows, Notebooks, Rules, and Prompts publicly from Warp Drive.
- Find an issue to pick up - Browse
build.warp.dev, a live dashboard of the work Warp’s agents are tackling acrosswarpdotdev/warp. Use it to spot gaps, avoid duplicate work, and surface issues that haven’t been claimed yet. - Help others in the community - Answer questions in the Warp community Slack or Discord, and join conversations in GitHub Discussions.
Send feedback and bug reports
Section titled “Send feedback and bug reports”The fastest way to file a bug or feature request is the /feedback slash command inside Warp. It drafts and files a GitHub issue without leaving the terminal.
Other channels:
- File an issue directly in
warpdotdev/warp. - Press
⌘+Shift+F(macOS) orCtrl+Shift+F(Windows/Linux) to open the in-app feedback dialog. On macOS, you can also use the Send Feedback option in Warp’s Help menu. - Email privacy@warp.dev for privacy questions.
For logs, crash reports, CPU samples, and AI debugging IDs, see Sending feedback and logs.
Reporting security issues
Section titled “Reporting security issues”Email security@warp.dev with reproduction steps, impact, and any proof of concept. We’ll acknowledge receipt and coordinate a fix and disclosure. Full guidance is in CONTRIBUTING.md.
Code of conduct
Section titled “Code of conduct”Warp’s open source repositories follow the Contributor Covenant v2.1. Read the full text, or report violations to warp-coc@warp.dev.