docs: update README to reflect current CLI features

Add documentation for apps management, chains command, access key
authentication, interactive REPL mode, and version command.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: CodesMcCabe

README.md

@@ -10,7 +10,14 @@ pnpm add -g @alchemyplatform/cli
 
 ## Authentication
 
-Set your Alchemy API key (get one at [alchemy.com](https://dashboard.alchemy.com/)):
+The CLI uses two types of keys:
+
+- **API key** — for blockchain queries (balance, tx, block, nfts, tokens, rpc)
+- **Access key** — for the Admin API (apps, chains)
+
+Get both at [alchemy.com](https://dashboard.alchemy.com/).
+
+### API key
 
 ```bash
 # Option 1: config file
@@ -23,10 +30,36 @@ export ALCHEMY_API_KEY=<your-key>
 alchemy balance 0x... --api-key <your-key>
 ```
 
-Resolution order: `--api-key` flag → `ALCHEMY_API_KEY` env var → config file.
+Resolution order: `--api-key` flag → `ALCHEMY_API_KEY` env var → config file → configured app's API key.
+
+### Access key
+
+```bash
+# Option 1: config file (triggers interactive app setup in TTY)
+alchemy config set access-key <your-key>
+
+# Option 2: environment variable
+export ALCHEMY_ACCESS_KEY=<your-key>
+
+# Option 3: per-command flag
+alchemy apps list --access-key <your-key>
+```
+
+Resolution order: `--access-key` flag → `ALCHEMY_ACCESS_KEY` env var → config file.
 
 ## Usage
 
+### Interactive REPL
+
+Run `alchemy` with no arguments in a terminal to enter interactive mode with tab-completion:
+
+```bash
+alchemy
+alchemy ◆ balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
+alchemy ◆ block latest
+alchemy ◆ exit
+```
+
 ### Get an ETH balance
 
 ```bash
@@ -65,6 +98,43 @@ alchemy rpc eth_blockNumber
 alchemy rpc eth_getBalance "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" "latest"
 ```
 
+### Manage apps
+
+Requires an access key.
+
+```bash
+# List all apps
+alchemy apps list
+
+# Get app details
+alchemy apps get <app-id>
+
+# Create a new app
+alchemy apps create --name "My App" --networks eth-mainnet,polygon-mainnet
+
+# Update an app
+alchemy apps update <app-id> --name "New Name"
+
+# Delete an app
+alchemy apps delete <app-id>
+
+# Update network allowlist
+alchemy apps networks <app-id> --networks eth-mainnet,arb-mainnet
+
+# Update address/origin/IP allowlists
+alchemy apps address-allowlist <app-id> --addresses 0xabc,0xdef
+alchemy apps origin-allowlist <app-id> --origins https://example.com
+alchemy apps ip-allowlist <app-id> --ips 1.2.3.4,5.6.7.8
+```
+
+### List chain networks
+
+Requires an access key.
+
+```bash
+alchemy chains list
+```
+
 ### List supported networks
 
 ```bash
@@ -75,16 +145,25 @@ alchemy network list
 
 ```bash
 alchemy config set api-key <key>
+alchemy config set access-key <key>
+alchemy config set app              # interactive app selector
 alchemy config set network polygon-mainnet
 alchemy config get api-key
 alchemy config list
 ```
 
+### Print version
+
+```bash
+alchemy version
+```
+
 ## Global Flags
 
 | Flag | Env Var | Description |
 |------|---------|-------------|
-| `--api-key` | `ALCHEMY_API_KEY` | API key for requests |
+| `--api-key` | `ALCHEMY_API_KEY` | API key for blockchain queries |
+| `--access-key` | `ALCHEMY_ACCESS_KEY` | Access key for Admin API operations |
 | `--network, -n` | `ALCHEMY_NETWORK` | Target network (default: `eth-mainnet`) |
 | `--json` | — | Force JSON output |
 | `--quiet, -q` | — | Suppress non-essential output |