Petra DonkaandOz
bfdd0796ed
## Description Adds a top-level `FAQ.md` covering the questions most likely to come up for someone landing on this repo for the first time, especially someone planning to contribute or run an agent against it. Sections: - **Contributing** — how to contribute, filing good issues, readiness labels, why feature work goes through a spec PR, building from source, the Oz + SME review flow, what to do when a PR is stuck, becoming a collaborator. - **Using an agent on this repo** — bringing your own agent, how to get Oz to implement an issue for you, cost, the quality bar for agent-generated PRs, training data. - **What's open source and what isn't** — straightforward answers about which parts of Warp live in this repo (the client) and which don't (the server, Drive backend, Oz), and what running locally without the cloud looks like. - **Licensing** — why we chose AGPL for the app and MIT for the UI framework crates, enterprise use, the CLA, forking. - **Help and security** — where to ask questions, how to report security issues. Most of the substance is already implied by `README.md`, `CONTRIBUTING.md`, `SECURITY.md`, and the licenses; the FAQ pulls those answers into one skimmable place and answers a few questions that aren't covered elsewhere (e.g. "is Warp fully open source", "can I get Oz to implement my issue", "why AGPL"). ## Testing Documentation-only change. Verified the rendered Markdown locally and that all in-repo links resolve. ## Changelog Entries for Stable <!-- Docs-only addition; no changelog entry. --> --------- Co-authored-by: Oz <oz-agent@warp.dev>
Website · Code · Agents · Terminal · Drive · Docs · How Warp Works
Note
OpenAI is the founding sponsor of the new, open-source Warp repository, and the new agentic management workflows are powered by GPT models.
About
Warp is an agentic development environment, born out of the terminal. Use Warp's built-in coding agent, or bring your own CLI agent (Claude Code, Codex, Gemini CLI, and others).
Installation
You can download Warp and read our docs for platform-specific instructions.
Licensing
Warp's UI framework (the warpui_core and warpui crates) are licensed under the MIT license.
The rest of the code in this repository is licensed under the AGPL v3.
Open Source & Contributing
Warp's client codebase is open source and lives in this repository. We welcome community contributions and have designed a lightweight workflow to help new contributors get started. For the full contribution flow, read our CONTRIBUTING.md guide.
Issue to PR
Before filing, search existing issues for your bug or feature request. If nothing exists, file an issue using our templates. Security vulnerabilities should be reported privately as described in CONTRIBUTING.md.
Once filed, a Warp maintainer reviews the issue and may apply a readiness label: ready-to-spec signals the design is open for contributors to spec out, and ready-to-implement signals the design is settled and code PRs are welcome. Anyone can pick up a labeled issue — mention @oss-maintainers on an issue if you'd like it considered for a readiness label.
Building the Repo Locally
To build and run Warp from source:
./script/bootstrap # platform-specific setup
./script/run # build and run Warp
./script/presubmit # fmt, clippy, and tests
See WARP.md for the full engineering guide, including coding style, testing, and platform-specific notes.
Joining the Team
Interested in joining the team? See our open roles.
Support and Questions
- See our docs for a comprehensive guide to Warp's features.
- Join our Slack Community to connect with other users and get help from the Warp team.
- Try our Preview build to test the latest experimental features.
- Mention @oss-maintainers on any issue to escalate to the team — for example, if you encounter problems with the automated agents.
Code of Conduct
We ask everyone to be respectful and empathetic. Warp follows the Code of Conduct. To report violations, email warp-coc at warp.dev.
Open Source Dependencies
We'd like to call out a few of the open source dependencies that have helped Warp to get off the ground: