update readme

Author: xlc

README.md

@@ -4,12 +4,57 @@ Boka / 波卡 / bō kǎ: A JAM implementation built with Swift, brought to you b
 
 ## Development Environment
 
-- Install tools and deps
-  - macos: `brew install swiftlint swiftformat rocksdb openssl`
-  - linux: `apt-get install librocksdb-dev libzstd-dev libbz2-dev liblz4-dev libssl-dev`
-- Precommit hooks: `make githooks`
-- Pull submodules: `git submodule update --init --recursive`
-- Setup deps: `make deps`
+Install tools and dependencies:
+
+**macOS**
+```bash
+brew install swiftlint swiftformat rocksdb openssl
+```
+
+**Linux**
+```bash
+apt-get install librocksdb-dev libzstd-dev libbz2-dev liblz4-dev libssl-dev
+```
+
+Setup the project:
+
+```bash
+# Install precommit hooks
+make githooks
+
+# Pull submodules
+git submodule update --init --recursive
+
+# Setup dependencies
+make deps
+```
+
+## Run
+
+- Run the node: `make run`
+- Run a devnet: `make devnet`
+
+## CLI Usage
+
+The Boka CLI supports the following arguments:
+
+- `--base-path <path>`: Base path to database files.
+- `--chain <chain>`: A preset config or path to chain config file. Default: `minimal`.
+- `--rpc <address>`: Listen address for RPC server. Pass 'no' to disable. Default: `127.0.0.1:9955`.
+- `--p2p <address>`: Listen address for P2P protocol. Default: `127.0.0.1:0`.
+- `--peers <address>`: Specify peer P2P addresses.
+- `--validator`: Run as a validator.
+- `--operator-rpc <address>`: Listen address for operator RPC server. Pass 'false' to disable.
+- `--dev-seed <seed>`: For development only. Seed for validator keys.
+- `--name <name>`: Node name. For telemetry only.
+- `--local`: Enable local mode, whereas peers are not expected.
+- `--dev`: Enable dev mode. This is equivalent to `--local --validator`.
+
+## Testing
+
+- Run Swift tests: `make test`
+- Run Rust tests: `make test-cargo`
+- Run tests with coverage: `make test-coverage`
 
 ## Packages
 
@@ -25,5 +70,9 @@ Boka / 波卡 / bō kǎ: A JAM implementation built with Swift, brought to you b
   - Provide the database interface for the blockchain node. Used by `Node`.
 - Networking
   - Provide the networking interface for the blockchain node. Used by `Node`.
+- PolkaVM
+  - The PVM implementation.
+- Codec
+  - The JAM codec implementation.
 - Utils
   - Provide the common utilities for the blockchain node.