docs: update installation and usage instructions for Forge CLI

- Clarified prerequisites by specifying the need for the Forge CLI in the first-app tutorial.
- Enhanced the installation guide to include detailed steps for installing the Forge CLI via various methods (Homebrew, Go, Scoop, binary download, Linux packages, Docker).
- Updated quick start guide to reflect the use of `forge dev` for running applications instead of `go run`.
- Added a new document for the Forge CLI, outlining its command structure, core commands, and quick start examples.

These changes improve the clarity and accessibility of the documentation, ensuring users have the necessary information to effectively use the Forge CLI.

Author: juicycleff

docs/content/docs/forge/(cli)/build-deploy.mdx

@@ -685,13 +685,13 @@ deploy_production:
 
 ```bash
 # Check for syntax errors
-go build ./cmd/api-gateway
+forge build -a api-gateway
 
 # Check dependencies
 go mod tidy
 
 # Build with verbose output
-forge build --verbose
+forge build -a api-gateway --verbose
 ```
 
 ### Docker Build Issues

docs/content/docs/forge/(cli)/index.mdx docs/content/docs/forge/(cli)/cli.mdxdocs/content/docs/forge/(cli)/index.mdx renamed to docs/content/docs/forge/(cli)/cli.mdx

@@ -15,13 +15,18 @@ Forge provides a comprehensive command-line interface that helps you develop, bu
 ### Install the CLI Tool
 
 ```bash
-# Install the latest version
+# Homebrew (macOS/Linux) - recommended
+brew install xraph/tap/forge
+
+# Or using Go install
 go install github.com/xraph/forge/cmd/forge@latest
 
 # Verify installation
 forge version
 ```
 
+See the [Installation](/docs/forge/installation) guide for all available methods (Scoop, binary download, Linux packages, Docker).
+
 ### CLI Commands Overview
 
 ```bash

docs/content/docs/forge/(cli)/development.mdx

@@ -507,8 +507,8 @@ forge dev build -a my-app
 
 **Solution:**
 ```bash
-# Check for syntax errors
-go build ./cmd/my-app
+# Retry the build
+forge dev build -a my-app
 
 # Install dependencies
 go mod tidy

docs/content/docs/forge/(cli)/meta.json

@@ -1,7 +1,7 @@
 {
   "title": "Forge CLI",
   "pages": [
-    "index",
+    "router",
     "system",
     "development",
     "code-generation",

docs/content/docs/forge/first-app.mdx

@@ -20,7 +20,7 @@ In this tutorial, you will build a complete TODO REST API with CRUD operations,
 
 ## Prerequisites
 
-Make sure you have completed the [Installation](/docs/forge/installation) guide and have Go 1.21+ installed.
+Make sure you have completed the [Installation](/docs/forge/installation) guide, have Go 1.21+ installed, and have the Forge CLI available (`forge version`).
 
 ---
 
@@ -284,8 +284,8 @@ If a handler returns a plain `error` (not an `HTTPError`), Forge automatically w
 Start the server and run through the full CRUD cycle:
 
 ```bash
-# Start the server
-go run main.go
+# Start the development server
+forge dev
 ```
 
 In another terminal:

docs/content/docs/forge/installation.mdx

@@ -1,6 +1,6 @@
 ---
 title: Installation
-description: Install Forge and set up your development environment
+description: Install the Forge CLI and set up your development environment
 icon: Download
 ---
 
@@ -19,7 +19,123 @@ import { Tabs, Tab } from 'fumadocs-ui/components/tabs';
 Forge uses Go generics extensively for type-safe dependency injection. Go 1.21 or later is required.
 </Callout>
 
-## Install Forge
+## Install the Forge CLI
+
+The Forge CLI (`forge`) is the primary tool for developing, building, and managing Forge applications. It provides hot-reload development servers, code generation, database migrations, and more.
+
+<Tabs items={["Homebrew (macOS/Linux)", "Go Install", "Scoop (Windows)", "Binary Download", "Linux Packages", "Docker"]}>
+<Tab value="Homebrew (macOS/Linux)">
+
+The recommended way to install on macOS and Linux:
+
+```bash
+brew install xraph/tap/forge
+```
+
+To upgrade to the latest version:
+
+```bash
+brew upgrade xraph/tap/forge
+```
+
+</Tab>
+<Tab value="Go Install">
+
+If you already have Go installed:
+
+```bash
+go install github.com/xraph/forge/cmd/forge@latest
+```
+
+Make sure `$GOPATH/bin` (or `$HOME/go/bin`) is in your `PATH`.
+
+</Tab>
+<Tab value="Scoop (Windows)">
+
+Install using [Scoop](https://scoop.sh):
+
+```bash
+scoop bucket add xraph https://github.com/xraph/scoop-bucket
+scoop install forge
+```
+
+To upgrade:
+
+```bash
+scoop update forge
+```
+
+</Tab>
+<Tab value="Binary Download">
+
+Download the pre-built binary for your platform from the [GitHub Releases](https://github.com/xraph/forge/releases) page.
+
+1. Download the archive for your OS and architecture (e.g., `forge-x.x.x-darwin-arm64.tar.gz`)
+2. Extract the binary:
+
+```bash
+tar -xzf forge-*.tar.gz
+```
+
+3. Move it to a directory in your `PATH`:
+
+```bash
+sudo mv forge /usr/local/bin/
+```
+
+4. Verify:
+
+```bash
+forge version
+```
+
+</Tab>
+<Tab value="Linux Packages">
+
+Pre-built `.deb`, `.rpm`, `.apk`, and Arch Linux packages are available on the [GitHub Releases](https://github.com/xraph/forge/releases) page.
+
+```bash
+# Debian / Ubuntu
+sudo dpkg -i forge_*.deb
+
+# Fedora / RHEL
+sudo rpm -i forge_*.rpm
+
+# Alpine
+sudo apk add --allow-untrusted forge_*.apk
+```
+
+</Tab>
+<Tab value="Docker">
+
+The Forge CLI is also available as a Docker image:
+
+```bash
+docker pull ghcr.io/xraph/forge:latest
+```
+
+Run it:
+
+```bash
+docker run --rm ghcr.io/xraph/forge:latest version
+```
+
+</Tab>
+</Tabs>
+
+### Verify the CLI
+
+After installation, confirm the CLI is available:
+
+```bash
+forge version
+```
+
+You should see version, commit, and build information printed to the terminal.
+
+## Add Forge to Your Project
+
+Once the CLI is installed, set up Forge as a Go dependency in your project.
 
 <Steps>
 <Step>
@@ -51,9 +167,9 @@ go get github.com/xraph/forge/extensions/grpc@latest
 </Step>
 
 <Step>
-### Verify the installation
+### Verify the library
 
-Create a minimal `main.go` to confirm everything works:
+Create a minimal `main.go` to confirm the library is working:
 
 ```go
 package main
@@ -71,12 +187,13 @@ func main() {
 }
 ```
 
-Run it:
+Run it using the Forge CLI:
 
 ```bash
-go run main.go
-# Forge app created: install-check
+forge dev
 ```
+
+You should see the Forge startup banner with your application name and the address it is listening on.
 </Step>
 </Steps>
 

docs/content/docs/forge/quick-start.mdx

@@ -14,6 +14,7 @@ This guide walks you through creating your first Forge application from scratch.
 
 <Callout type="info">
 Forge requires **Go 1.21 or later**. Check your version with `go version`.
+Make sure you have the Forge CLI installed. See the [Installation](/docs/forge/installation) guide.
 </Callout>
 
 ## Build Your First Server
@@ -81,10 +82,10 @@ func main() {
 ### Run your application
 
 ```bash
-go run main.go
+forge dev
 ```
 
-You should see a startup banner with your application name, version, and the address it is listening on.
+The Forge CLI starts a development server with hot reload enabled by default. You should see a startup banner with your application name, version, and the address it is listening on.
 </Step>
 
 <Step>