Revise README, symlink to main package

README.md

@@ -0,0 +1 @@
+./packages/cli/README.md

packages/cli/README.md

@@ -1,7 +1,83 @@
-# React Native CLI
+# React Native Community CLI
 
-Command line tools to interact with React Native projects.
+[![npm package](https://img.shields.io/npm/v/@react-native-community/cli?label=latest%20stable)](https://www.npmjs.com/package/@react-native-community/cli)
 
-This package contains source code for `@react-native-community/cli`, the actual CLI that comes bundled with React Native. You don't need to install it separately in your project.
+Command line tools for building apps with [React Native](https://reactnative.dev), shipped as the `@react-native-community/cli` npm package.
 
-See the [list of available commands](../../docs/commands.md).
+See also the [Community Template](https://github.com/react-native-community/template).
+
+## Docs
+
+- [Initializing a new project](https://github.com/react-native-community/cli/tree/main/docs/init.md)
+- [Configuration](https://github.com/react-native-community/cli/tree/main/docs/configuration.md)
+- [Commands](https://github.com/react-native-community/cli/tree/main/docs/commands.md)
+- [Plugins](https://github.com/react-native-community/cli/tree/main/docs/plugins.md)
+- [Autolinking](https://github.com/react-native-community/cli/tree/main/docs/autolinking.md)
+
+## Compatibility
+
+Our release cycle is independent of `react-native`.
+
+> [!Warning]
+> **Important**: `@react-native-community/cli` is designed to work with specific `react-native` versions. We do not recommend updating CLI independently, as it may cause unexpected issues.
+
+| `@react-native-community/cli`                                      | `react-native`            |
+| ------------------------------------------------------------------ | ------------------------- |
+| [^20.0.0](https://github.com/react-native-community/cli/tree/main) | ^0.81.0, ^0.82.0, ^0.83.0, ^0.84.0, ^0.85.0 |
+| [^19.0.0](https://github.com/react-native-community/cli/tree/19.x) | ^0.80.0                   |
+| [^18.0.0](https://github.com/react-native-community/cli/tree/18.x) | ^0.79.0                   |
+| [^15.0.0](https://github.com/react-native-community/cli/tree/15.x) | ^0.76.0, ^0.77.0, ^0.78.0 |
+
+[Previous versions](https://github.com/react-native-community/cli/blob/b26aa65/README.md)
+
+## Creating a new React Native project
+
+Run the following command in your terminal prompt:
+
+```sh
+npx @react-native-community/cli@latest init MyApp
+```
+
+See more options for the `init` command [here](https://github.com/react-native-community/cli/blob/main/docs/init.md).
+
+## Usage in an existing React Native project
+
+Once installed, you can run commands to interact with your projects by using the `rnc-cli` binary.
+
+Example running `start` command in terminal:
+
+```sh
+yarn rnc-cli start
+```
+
+You can also add npm scripts to call it with whichever package manager you use:
+
+```json
+{
+  "scripts": {
+    "start": "rnc-cli start"
+  }
+}
+```
+
+to call it as
+
+```sh
+yarn start
+```
+
+## Maintainers
+
+- Michał Pierzchała ([**@thymikee**](https://github.com/thymikee)) - [Callstack](https://callstack.com)
+- Alex Hunt ([**@huntie**](https://github.com/huntie)) - [Meta](https://meta.com)
+
+Previously:
+
+- Szymon Rybczak ([**@szymonrybczak**](https://github.com/szymonrybczak))
+- Mike Grabowski ([**@grabbou**](https://github.com/grabbou)) - [Callstack](https://callstack.com)
+- Kacper Wiszczuk ([**@esemesek**](https://github.com/esemesek)) - [Callstack](https://callstack.com)
+- Adam Trzciński ([**@adamTrz**](https://github.com/adamTrz)) - [Callstack](https://callstack.com)
+
+## License
+
+Everything inside this repository is [MIT licensed](./LICENSE).