Files
warp/README.md
Gulsah Sarsilmaz (She/Her) 1fa2fc30d2 docs: standardize bullet style to hyphens (GH9742) (#9937)
## Summary                              
Resolves the inconsistent bullet styling called out in #9742. Two files
in the core docs were mixing asterisk (`*`) and hyphen
(`-`) bullets within themselves, while every other top-level Markdown
file in the repo already uses hyphens uniformly:
   
- **`README.md`** — the nine *Open Source Dependencies* entries used `*`
while the rest of the file used `-`.
- **`.github/pull_request_template.md`** — the five `CHANGELOG-*` suffix
descriptions in the commented-out instruction block used
`*` while the visible *Linked Issue* checkboxes used `-`.
Both are now hyphens. After this PR every `.md` file in the seven core
docs (`CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, `FAQ.md`,
`README.md`, `SECURITY.md`, `WARP.md`,
`.github/pull_request_template.md`) uses the hyphen style consistently.
The other items mentioned in #9742 (header spacing, section dividers)
were spot-checked and are already consistent across these
files; no further changes were necessary. If a maintainer wants stricter
project-wide enforcement (e.g. a `markdownlint` config or
`prettier --parser markdown` run over the whole tree), that is a tooling
decision that warrants its own discussion and a much
larger diff — happy to follow up on a separate PR if there is interest.
                                         
## Linked Issue
  Closes #9742.                          

- [x] The linked issue is labeled `ready-to-spec` or
`ready-to-implement`.
- [ ] Where appropriate, screenshots or a short video of the
implementation are included below (especially for user-visible or UI
  changes).                                   
                                          
  N/A — docs-only change; no UI or behavior impact.
  ## Screenshots / Videos                     
N/A — docs-only.
  ## Testing
Verified post-edit with `grep -c '^\* \|^ \* \|^ \* '` over the seven
core `.md` files; all return `0` asterisk-bulleted lines.
  No code changes; no test-suite impact.  

## Agent Mode
   
- [ ] Warp Agent Mode - This PR was created via Warp's AI Agent Mode
2026-05-07 22:03:46 +00:00

6.0 KiB

Warp Agentic Development Environment product preview  

Built with Warp   Powered by Oz

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.

Warp Contributions Overview Dashboard

Explore build.warp.dev to:

  • Watch thousands of Oz agents triage issues, write specs, implement changes, and review PRs
  • View top contributors and in-flight features
  • Track your own issues with GitHub sign-in
  • Click into active agent sessions in a web-compiled Warp terminal

Oz for OSS

Maintaining a popular open-source project? Apply for Oz credits to explore Oz for OSS.

Oz for OSS is our partner program for bringing the same agentic open-source management workflows used in this repository to select partner repositories. We work directly with maintainers to implement workflows for issue triage, PR review, community management, and contributor coordination in a way that fits each project.

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.

Tip

Chat with contributors and the Warp team in the #oss-contributors Slack channel — a good place for ad-hoc questions, design discussion, and pairing with maintainers. New here? Join the Warp Slack community first, then jump into #oss-contributors.

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

  1. See our docs for a comprehensive guide to Warp's features.
  2. Join our Slack Community to connect with other users and get help from the Warp team — contributors hang out in #oss-contributors.
  3. Try our Preview build to test the latest experimental features.
  4. 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: