update README

Author: andrearcaina

README.md

@@ -28,6 +28,48 @@ Or via Go (requires Go 1.24.5 or later):
 go install github.com/andrearcaina/pathfinder@latest
 ```
 
+### CLI Usage
+
+To generate a Go REST server, run:
+```
+> goforge generate -p rest-server -n my-server -s REST -m
+```
+This command does the following:
+- Creates a directory named `rest-server`
+- Initializes a `go.mod` file with the module name `my-server`
+- Configures the server type as `REST`
+- Generates a `Makefile`
+
+### Interactive Mode (TUI)
+
+If any required flags are missing, an interactive TUI will appear:
+![goforge-no-db-flag](images/goforge-no-db-flag.png)
+
+You can see that the TUI appears, asking if you should generate the database files.
+
+The following fields must be provided either via CLI flags or through the TUI:
+
+```go
+type ServerTypeFlag string
+
+const (
+	REST    ServerTypeFlag = "rest"
+	GRPC    ServerTypeFlag = "grpc"
+	GraphQL ServerTypeFlag = "graphql"
+)
+
+type Form struct {
+	Name           string
+	ServerTypeFlag ServerTypeFlag
+	DatabaseFlag   bool
+	MakefileFlag   bool
+}
+```
+If you run with the database flag enabled (including `--database`), the TUI is skipped and will generate your server (since the form is technically filled out).
+
+For example, the following command will trigger the TUI:
+![goforge TUI](images/goforge-tui.png)
+
 ### TODO
 
 In no particular order: