Initial Commit

.gitignore

···
+*.iso
+*.img

.vscode/extensions.json

···
+{
+  "recommendations": [
+    "denoland.vscode-deno"
+  ]
+}

.vscode/settings.json

···
+{
+  "deno.enable": true,
+  "deno.lint": true,
+  "editor.defaultFormatter": "denoland.vscode-deno",
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "denoland.vscode-deno"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "denoland.vscode-deno"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "denoland.vscode-deno"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "denoland.vscode-deno"
+  }
+}

LICENSE

···
+Copyright (c) 2025 Tsiry Sandratraina <[e-mail]>
+
+Mozilla Public License, version 2.0
+
+1. Definitions
+
+1.1. "Contributor"
+
+     means each individual or legal entity that creates, contributes to the
+     creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+
+     means the combination of the Contributions of others (if any) used by a
+     Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+
+     means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+
+     means Source Code Form to which the initial Contributor has attached the
+     notice in Exhibit A, the Executable Form of such Source Code Form, and
+     Modifications of such Source Code Form, in each case including portions
+     thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+     means
+
+     a. that the initial Contributor has attached the notice described in
+        Exhibit B to the Covered Software; or
+
+     b. that the Covered Software was made available under the terms of
+        version 1.1 or earlier of the License, but not also under the terms of
+        a Secondary License.
+
+1.6. "Executable Form"
+
+     means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+
+     means a work that combines Covered Software with other material, in a
+     separate file or files, that is not Covered Software.
+
+1.8. "License"
+
+     means this document.
+
+1.9. "Licensable"
+
+     means having the right to grant, to the maximum extent possible, whether
+     at the time of the initial grant or subsequently, any and all of the
+     rights conveyed by this License.
+
+1.10. "Modifications"
+
+     means any of the following:
+
+     a. any file in Source Code Form that results from an addition to,
+        deletion from, or modification of the contents of Covered Software; or
+
+     b. any new file in Source Code Form that contains any Covered Software.
+
+1.11. "Patent Claims" of a Contributor
+
+      means any patent claim(s), including without limitation, method,
+      process, and apparatus claims, in any patent Licensable by such
+      Contributor that would be infringed, but for the grant of the License,
+      by the making, using, selling, offering for sale, having made, import,
+      or transfer of either its Contributions or its Contributor Version.
+
+1.12. "Secondary License"
+
+      means either the GNU General Public License, Version 2.0, the GNU Lesser
+      General Public License, Version 2.1, the GNU Affero General Public
+      License, Version 3.0, or any later versions of those licenses.
+
+1.13. "Source Code Form"
+
+      means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+
+      means an individual or a legal entity exercising rights under this
+      License. For legal entities, "You" includes any entity that controls, is
+      controlled by, or is under common control with You. For purposes of this
+      definition, "control" means (a) the power, direct or indirect, to cause
+      the direction or management of such entity, whether by contract or
+      otherwise, or (b) ownership of more than fifty percent (50%) of the
+      outstanding shares or beneficial ownership of such entity.
+
+
+2. License Grants and Conditions
+
+2.1. Grants
+
+     Each Contributor hereby grants You a world-wide, royalty-free,
+     non-exclusive license:
+
+     a. under intellectual property rights (other than patent or trademark)
+        Licensable by such Contributor to use, reproduce, make available,
+        modify, display, perform, distribute, and otherwise exploit its
+        Contributions, either on an unmodified basis, with Modifications, or
+        as part of a Larger Work; and
+
+     b. under Patent Claims of such Contributor to make, use, sell, offer for
+        sale, have made, import, and otherwise transfer either its
+        Contributions or its Contributor Version.
+
+2.2. Effective Date
+
+     The licenses granted in Section 2.1 with respect to any Contribution
+     become effective for each Contribution on the date the Contributor first
+     distributes such Contribution.
+
+2.3. Limitations on Grant Scope
+
+     The licenses granted in this Section 2 are the only rights granted under
+     this License. No additional rights or licenses will be implied from the
+     distribution or licensing of Covered Software under this License.
+     Notwithstanding Section 2.1(b) above, no patent license is granted by a
+     Contributor:
+
+     a. for any code that a Contributor has removed from Covered Software; or
+
+     b. for infringements caused by: (i) Your and any other third party's
+        modifications of Covered Software, or (ii) the combination of its
+        Contributions with other software (except as part of its Contributor
+        Version); or
+
+     c. under Patent Claims infringed by Covered Software in the absence of
+        its Contributions.
+
+     This License does not grant any rights in the trademarks, service marks,
+     or logos of any Contributor (except as may be necessary to comply with
+     the notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+     No Contributor makes additional grants as a result of Your choice to
+     distribute the Covered Software under a subsequent version of this
+     License (see Section 10.2) or under the terms of a Secondary License (if
+     permitted under the terms of Section 3.3).
+
+2.5. Representation
+
+     Each Contributor represents that the Contributor believes its
+     Contributions are its original creation(s) or it has sufficient rights to
+     grant the rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+     This License is not intended to limit any rights You have under
+     applicable copyright doctrines of fair use, fair dealing, or other
+     equivalents.
+
+2.7. Conditions
+
+     Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in
+     Section 2.1.
+
+
+3. Responsibilities
+
+3.1. Distribution of Source Form
+
+     All distribution of Covered Software in Source Code Form, including any
+     Modifications that You create or to which You contribute, must be under
+     the terms of this License. You must inform recipients that the Source
+     Code Form of the Covered Software is governed by the terms of this
+     License, and how they can obtain a copy of this License. You may not
+     attempt to alter or restrict the recipients' rights in the Source Code
+     Form.
+
+3.2. Distribution of Executable Form
+
+     If You distribute Covered Software in Executable Form then:
+
+     a. such Covered Software must also be made available in Source Code Form,
+        as described in Section 3.1, and You must inform recipients of the
+        Executable Form how they can obtain a copy of such Source Code Form by
+        reasonable means in a timely manner, at a charge no more than the cost
+        of distribution to the recipient; and
+
+     b. You may distribute such Executable Form under the terms of this
+        License, or sublicense it under different terms, provided that the
+        license for the Executable Form does not attempt to limit or alter the
+        recipients' rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+     You may create and distribute a Larger Work under terms of Your choice,
+     provided that You also comply with the requirements of this License for
+     the Covered Software. If the Larger Work is a combination of Covered
+     Software with a work governed by one or more Secondary Licenses, and the
+     Covered Software is not Incompatible With Secondary Licenses, this
+     License permits You to additionally distribute such Covered Software
+     under the terms of such Secondary License(s), so that the recipient of
+     the Larger Work may, at their option, further distribute the Covered
+     Software under the terms of either this License or such Secondary
+     License(s).
+
+3.4. Notices
+
+     You may not remove or alter the substance of any license notices
+     (including copyright notices, patent notices, disclaimers of warranty, or
+     limitations of liability) contained within the Source Code Form of the
+     Covered Software, except that You may alter any license notices to the
+     extent required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+     You may choose to offer, and to charge a fee for, warranty, support,
+     indemnity or liability obligations to one or more recipients of Covered
+     Software. However, You may do so only on Your own behalf, and not on
+     behalf of any Contributor. You must make it absolutely clear that any
+     such warranty, support, indemnity, or liability obligation is offered by
+     You alone, and You hereby agree to indemnify every Contributor for any
+     liability incurred by such Contributor as a result of warranty, support,
+     indemnity or liability terms You offer. You may include additional
+     disclaimers of warranty and limitations of liability specific to any
+     jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+
+   If it is impossible for You to comply with any of the terms of this License
+   with respect to some or all of the Covered Software due to statute,
+   judicial order, or regulation then You must: (a) comply with the terms of
+   this License to the maximum extent possible; and (b) describe the
+   limitations and the code they affect. Such description must be placed in a
+   text file included with all distributions of the Covered Software under
+   this License. Except to the extent prohibited by statute or regulation,
+   such description must be sufficiently detailed for a recipient of ordinary
+   skill to be able to understand it.
+
+5. Termination
+
+5.1. The rights granted under this License will terminate automatically if You
+     fail to comply with any of its terms. However, if You become compliant,
+     then the rights granted under this License from a particular Contributor
+     are reinstated (a) provisionally, unless and until such Contributor
+     explicitly and finally terminates Your grants, and (b) on an ongoing
+     basis, if such Contributor fails to notify You of the non-compliance by
+     some reasonable means prior to 60 days after You have come back into
+     compliance. Moreover, Your grants from a particular Contributor are
+     reinstated on an ongoing basis if such Contributor notifies You of the
+     non-compliance by some reasonable means, this is the first time You have
+     received notice of non-compliance with this License from such
+     Contributor, and You become compliant prior to 30 days after Your receipt
+     of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+     infringement claim (excluding declaratory judgment actions,
+     counter-claims, and cross-claims) alleging that a Contributor Version
+     directly or indirectly infringes any patent, then the rights granted to
+     You by any and all Contributors for the Covered Software under Section
+     2.1 of this License shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user
+     license agreements (excluding distributors and resellers) which have been
+     validly granted by You or Your distributors under this License prior to
+     termination shall survive termination.
+
+6. Disclaimer of Warranty
+
+   Covered Software is provided under this License on an "as is" basis,
+   without warranty of any kind, either expressed, implied, or statutory,
+   including, without limitation, warranties that the Covered Software is free
+   of defects, merchantable, fit for a particular purpose or non-infringing.
+   The entire risk as to the quality and performance of the Covered Software
+   is with You. Should any Covered Software prove defective in any respect,
+   You (not any Contributor) assume the cost of any necessary servicing,
+   repair, or correction. This disclaimer of warranty constitutes an essential
+   part of this License. No use of  any Covered Software is authorized under
+   this License except under this disclaimer.
+
+7. Limitation of Liability
+
+   Under no circumstances and under no legal theory, whether tort (including
+   negligence), contract, or otherwise, shall any Contributor, or anyone who
+   distributes Covered Software as permitted above, be liable to You for any
+   direct, indirect, special, incidental, or consequential damages of any
+   character including, without limitation, damages for lost profits, loss of
+   goodwill, work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses, even if such party shall have been
+   informed of the possibility of such damages. This limitation of liability
+   shall not apply to liability for death or personal injury resulting from
+   such party's negligence to the extent applicable law prohibits such
+   limitation. Some jurisdictions do not allow the exclusion or limitation of
+   incidental or consequential damages, so this exclusion and limitation may
+   not apply to You.
+
+8. Litigation
+
+   Any litigation relating to this License may be brought only in the courts
+   of a jurisdiction where the defendant maintains its principal place of
+   business and such litigation shall be governed by laws of that
+   jurisdiction, without reference to its conflict-of-law provisions. Nothing
+   in this Section shall prevent a party's ability to bring cross-claims or
+   counter-claims.
+
+9. Miscellaneous
+
+   This License represents the complete agreement concerning the subject
+   matter hereof. If any provision of this License is held to be
+   unenforceable, such provision shall be reformed only to the extent
+   necessary to make it enforceable. Any law or regulation which provides that
+   the language of a contract shall be construed against the drafter shall not
+   be used to construe this License against a Contributor.
+
+
+10. Versions of the License
+
+10.1. New Versions
+
+      Mozilla Foundation is the license steward. Except as provided in Section
+      10.3, no one other than the license steward has the right to modify or
+      publish new versions of this License. Each version will be given a
+      distinguishing version number.
+
+10.2. Effect of New Versions
+
+      You may distribute the Covered Software under the terms of the version
+      of the License under which You originally received the Covered Software,
+      or under the terms of any subsequent version published by the license
+      steward.
+
+10.3. Modified Versions
+
+      If you create software not governed by this License, and you want to
+      create a new license for such software, you may create and use a
+      modified version of this License if you rename the license and remove
+      any references to the name of the license steward (except to note that
+      such modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary
+      Licenses If You choose to distribute Source Code Form that is
+      Incompatible With Secondary Licenses under the terms of this version of
+      the License, the notice described in Exhibit B of this License must be
+      attached.
+
+Exhibit A - Source Code Form License Notice
+
+      This Source Code Form is subject to the
+      terms of the Mozilla Public License, v.
+      2.0. If a copy of the MPL was not
+      distributed with this file, You can
+      obtain one at
+      http://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular file,
+then You may include the notice in a location (such as a LICENSE file in a
+relevant directory) where a recipient would be likely to look for such a
+notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - "Incompatible With Secondary Licenses" Notice
+
+      This Source Code Form is "Incompatible
+      With Secondary Licenses", as defined by
+      the Mozilla Public License, v. 2.0.

README.md

···
+# 🌅 OpenIndiana Up
+
+> A simple, powerful CLI tool to spin up OpenIndiana virtual machines with QEMU
+
+![Preview](./preview.png)
+
+## ✨ Features
+
+- 🚀 **Quick Start** - Launch OpenIndiana VMs with a single command
+- 📦 **Auto-Download** - Automatically downloads ISO images from official
+  sources
+- 🎯 **Version Support** - Specify exact OpenIndiana versions or use the latest
+  default
+- 💾 **Persistent Storage** - Attach virtual disk drives for data persistence
+- ⚡ **KVM Acceleration** - Native hardware acceleration for better performance
+- 🌐 **SSH Ready** - Pre-configured port forwarding (host:2222 → guest:22)
+- 🎛️ **Customizable** - Configure CPU, memory, cores, and disk options
+- 📥 **Smart Caching** - Skips re-downloading existing ISO files
+
+## 📋 Requirements
+
+- [Deno](https://deno.land/) runtime
+- QEMU with KVM support
+- Linux host with KVM enabled
+
+## 🛠️ Installation
+
+Run the following command to install the CLI:
+
+```bash
+deno install -A -g -r -f --config deno.json ./main.ts -n openindiana-up
+```
+
+## 🚀 Quick Start
+
+```bash
+# Use default OpenIndiana version (20251026)
+openindiana-up
+
+# Specify a version
+openindiana-up 20251026
+
+# Use a local ISO file
+openindiana-up /path/to/openindiana.iso
+
+# Download from a custom URL
+openindiana-up https://dlc.openindiana.org/isos/hipster/20251026/OI-hipster-text-20251026.iso
+```
+
+## 🎮 Usage
+
+```bash
+openindiana-up [path-or-url-to-iso-or-version] [options]
+```
+
+### Options
+
+| Option                   | Description                    | Default      |
+| ------------------------ | ------------------------------ | ------------ |
+| `-o, --output <path>`    | Output path for downloaded ISO | ISO filename |
+| `-c, --cpu <type>`       | CPU type to emulate            | `host`       |
+| `-C, --cpus <number>`    | Number of CPU cores            | `2`          |
+| `-m, --memory <size>`    | RAM allocation                 | `2G`         |
+| `-d, --drive <path>`     | Path to virtual disk image     | None         |
+| `--disk-format <format>` | Disk format (qcow2, raw, etc.) | `raw`        |
+
+## 💡 Examples
+
+### Basic VM with defaults
+
+```bash
+openindiana-up
+```
+
+### VM with custom resources
+
+```bash
+openindiana-up -C 4 -m 4G
+```
+
+### VM with persistent storage
+
+```bash
+# Create a disk image first
+qemu-img create -f qcow2 openindiana-disk.qcow2 20G
+
+# Launch with the disk attached
+openindiana-up -d openindiana-disk.qcow2 --disk-format qcow2
+```
+
+### Download to specific location
+
+```bash
+openindiana-up -o ~/isos/openindiana.iso
+```
+
+## 🖥️ Console Setup
+
+When FreeBSD boots, you'll see the boot menu. For the best experience with the
+serial console:
+
+1. **Select option `3. Escape to loader prompt`**
+2. **Configure console output:**
+   ```
+   set console=ttya
+   set osconsole=ttya
+   set ttya-mode=115200,8,n,1,-
+   boot
+   ```
+
+This enables proper console redirection to your terminal.
+
+## ⚙️ VM Configuration
+
+The script creates a VM with the following default specifications:
+
+- **CPU**: Host CPU with KVM acceleration (configurable with `--cpu`)
+- **Memory**: 2GB RAM (configurable with `--memory`)
+- **Cores**: 2 virtual CPUs (configurable with `--cpus`)
+- **Storage**: ISO-only by default; optional persistent disk (configurable with
+  `--drive`)
+- **Network**: User mode networking with SSH forwarding
+- **Console**: Enhanced serial console via stdio with proper signal handling
+- **Default Version**: FreeBSD 14.3-RELEASE (when no arguments provided)
+
+### Available CPU Types
+
+Common CPU types you can specify with `--cpu`:
+
+- `host` (default) - Use host CPU features for best performance
+- `qemu64` - Generic 64-bit CPU for maximum compatibility
+- `Broadwell` - Intel Broadwell CPU
+- `Skylake-Client` - Intel Skylake CPU
+- `max` - Enable all supported CPU features
+
+### Available Disk Formats
+
+Common disk formats you can specify with `--disk-format`:
+
+- `raw` (default) - Raw disk image format for maximum compatibility
+- `qcow2` - QEMU Copy On Write format with compression and snapshots
+- `vmdk` - VMware disk format
+- `vdi` - VirtualBox disk format
+
+## 🔌 SSH Access
+
+The VM is configured with port forwarding for SSH access:
+
+```bash
+# After OpenIndiana is installed and SSH is configured
+ssh -p 2222 user@localhost
+```
+
+## 📝 Notes
+
+- The script uses text-based installer ISOs for better headless compatibility
+- Downloaded ISOs are cached and won't be re-downloaded if they exist
+- KVM acceleration requires `/dev/kvm` access on your host system
+- Serial console is connected to stdio for direct interaction
+
+## 📜 License
+
+See [LICENSE](LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+
+---
+
+Made with ☀️ for OpenIndiana enthusiasts

deno.json

···
+{
+  "tasks": {
+    "dev": "deno run --watch main.ts"
+  },
+  "imports": {
+    "@cliffy/command": "jsr:@cliffy/command@^1.0.0-rc.8",
+    "@std/assert": "jsr:@std/assert@1",
+    "chalk": "npm:chalk@^5.6.2"
+  }
+}

deno.lock

···
+{
+  "version": "5",
+  "specifiers": {
+    "jsr:@cliffy/command@^1.0.0-rc.8": "1.0.0-rc.8",
+    "jsr:@cliffy/flags@1.0.0-rc.8": "1.0.0-rc.8",
+    "jsr:@cliffy/internal@1.0.0-rc.8": "1.0.0-rc.8",
+    "jsr:@cliffy/table@1.0.0-rc.8": "1.0.0-rc.8",
+    "jsr:@std/assert@1": "1.0.15",
+    "jsr:@std/fmt@~1.0.2": "1.0.8",
+    "jsr:@std/internal@^1.0.12": "1.0.12",
+    "jsr:@std/text@~1.0.7": "1.0.16",
+    "npm:chalk@^5.6.2": "5.6.2"
+  },
+  "jsr": {
+    "@cliffy/command@1.0.0-rc.8": {
+      "integrity": "758147790797c74a707e5294cc7285df665422a13d2a483437092ffce40b5557",
+      "dependencies": [
+        "jsr:@cliffy/flags",
+        "jsr:@cliffy/internal",
+        "jsr:@cliffy/table",
+        "jsr:@std/fmt",
+        "jsr:@std/text"
+      ]
+    },
+    "@cliffy/flags@1.0.0-rc.8": {
+      "integrity": "0f1043ce6ef037ba1cb5fe6b1bcecb25dc2f29371a1c17f278ab0f45e4b6f46c",
+      "dependencies": [
+        "jsr:@std/text"
+      ]
+    },
+    "@cliffy/internal@1.0.0-rc.8": {
+      "integrity": "34cdf2fad9b084b5aed493b138d573f52d4e988767215f7460daf0b918ff43d8"
+    },
+    "@cliffy/table@1.0.0-rc.8": {
+      "integrity": "8bbcdc2ba5e0061b4b13810a24e6f5c6ab19c09f0cce9eb691ccd76c7c6c9db5",
+      "dependencies": [
+        "jsr:@std/fmt"
+      ]
+    },
+    "@std/assert@1.0.15": {
+      "integrity": "d64018e951dbdfab9777335ecdb000c0b4e3df036984083be219ce5941e4703b",
+      "dependencies": [
+        "jsr:@std/internal"
+      ]
+    },
+    "@std/fmt@1.0.8": {
+      "integrity": "71e1fc498787e4434d213647a6e43e794af4fd393ef8f52062246e06f7e372b7"
+    },
+    "@std/internal@1.0.12": {
+      "integrity": "972a634fd5bc34b242024402972cd5143eac68d8dffaca5eaa4dba30ce17b027"
+    },
+    "@std/text@1.0.16": {
+      "integrity": "ddb9853b75119a2473857d691cf1ec02ad90793a2e8b4a4ac49d7354281a0cf8"
+    }
+  },
+  "npm": {
+    "chalk@5.6.2": {
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="
+    }
+  },
+  "workspace": {
+    "dependencies": [
+      "jsr:@cliffy/command@^1.0.0-rc.8",
+      "jsr:@std/assert@1",
+      "npm:chalk@^5.6.2"
+    ]
+  }
+}

main.ts

···
+#!/usr/bin/env -S deno run --allow-run --allow-read --allow-env
+
+import { Command } from "@cliffy/command";
+import chalk from "chalk";
+
+const DEFAULT_VERSION = "20251026";
+
+interface Options {
+  output?: string;
+  cpu: string;
+  cpus: number;
+  memory: string;
+  drive?: string;
+  diskFormat: string;
+}
+
+async function downloadIso(url: string, outputPath?: string): Promise<string> {
+  const filename = url.split("/").pop()!;
+  outputPath = outputPath ?? filename;
+
+  if (await Deno.stat(outputPath).catch(() => false)) {
+    console.log(
+      chalk.yellowBright(
+        `File ${outputPath} already exists, skipping download.`,
+      ),
+    );
+    return outputPath;
+  }
+
+  const cmd = new Deno.Command("curl", {
+    args: ["-L", "-o", outputPath, url],
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit",
+  });
+
+  const status = await cmd.spawn().status;
+  if (!status.success) {
+    console.error(chalk.redBright("Failed to download ISO image."));
+    Deno.exit(status.code);
+  }
+
+  console.log(chalk.greenBright(`Downloaded ISO to ${outputPath}`));
+  return outputPath;
+}
+
+function constructDownloadUrl(version: string): string {
+  return `https://dlc.openindiana.org/isos/hipster/${version}/OI-hipster-text-${version}.iso`;
+}
+
+async function runQemu(isoPath: string, options: Options): Promise<void> {
+  const cmd = new Deno.Command("qemu-system-x86_64", {
+    args: [
+      "-enable-kvm",
+      "-cpu",
+      options.cpu,
+      "-m",
+      options.memory,
+      "-smp",
+      options.cpus.toString(),
+      "-cdrom",
+      isoPath,
+      "-netdev",
+      "user,id=net0,hostfwd=tcp::2222-:22",
+      "-device",
+      "e1000,netdev=net0",
+      "-nographic",
+      "-monitor",
+      "none",
+      "-chardev",
+      "stdio,id=con0,signal=off",
+      "-serial",
+      "chardev:con0",
+      ...(options.drive
+        ? [
+          "-drive",
+          `file=${options.drive},format=${options.diskFormat},if=virtio`,
+        ]
+        : []),
+    ],
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit",
+  });
+
+  const status = await cmd.spawn().status;
+
+  if (!status.success) {
+    Deno.exit(status.code);
+  }
+}
+
+function handleInput(input?: string): string {
+  if (!input) {
+    console.log(
+      `No ISO path provided, defaulting to ${chalk.cyan("OpenIndiana")} ${
+        chalk.cyan(DEFAULT_VERSION)
+      }...`,
+    );
+    return constructDownloadUrl(DEFAULT_VERSION);
+  }
+
+  const versionRegex = /^\d{8}$/;
+
+  if (versionRegex.test(input)) {
+    console.log(
+      `Detected version ${chalk.cyan(input)}, constructing download URL...`,
+    );
+    return constructDownloadUrl(input);
+  }
+
+  return input;
+}
+
+if (import.meta.main) {
+  await new Command()
+    .name("openindiana-up")
+    .version("0.1.0")
+    .description("Start a OpenIndiana virtual machine using QEMU")
+    .arguments(
+      "[path-or-url-to-iso-or-version:string]",
+    )
+    .option("-o, --output <path:string>", "Output path for downloaded ISO")
+    .option("-c, --cpu <type:string>", "Type of CPU to emulate", {
+      default: "host",
+    })
+    .option("-C, --cpus <number:number>", "Number of CPU cores", {
+      default: 2,
+    })
+    .option("-m, --memory <size:string>", "Amount of memory for the VM", {
+      default: "2G",
+    })
+    .option("-d, --drive <path:string>", "Path to VM disk image")
+    .option(
+      "--disk-format <format:string>",
+      "Disk image format (e.g., qcow2, raw)",
+      {
+        default: "raw",
+      },
+    )
+    .example(
+      "Default usage",
+      "openindiana-up",
+    )
+    .example(
+      "Specific version",
+      "openindiana-up 20251026",
+    )
+    .example(
+      "Local ISO file",
+      "openindiana-up /path/to/openindiana.iso",
+    )
+    .example(
+      "Download URL",
+      "openindiana-up https://dlc.openindiana.org/isos/hipster/20251026/OI-hipster-text-20251026.iso",
+    )
+    .action(async (options: Options, input?: string) => {
+      const resolvedInput = handleInput(input);
+      let isoPath = resolvedInput;
+
+      if (
+        resolvedInput.startsWith("https://") ||
+        resolvedInput.startsWith("http://")
+      ) {
+        isoPath = await downloadIso(resolvedInput, options.output);
+      }
+
+      await runQemu(isoPath, {
+        cpu: options.cpu,
+        memory: options.memory,
+        cpus: options.cpus,
+        drive: options.drive,
+        diskFormat: options.diskFormat,
+      });
+    })
+    .parse(Deno.args);
+}