# opena-cli

**Repository Path**: ricsy/opena-cli

## Basic Information

- **Project Name**: opena-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opena-cli

[![Version](https://img.shields.io/npm/v/opena-cli.svg)](https://npmjs.com/package/opena-cli)
[![License](https://img.shields.io/npm/l/opena-cli.svg)](https://github.com/riscy/opena-cli/blob/main/LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-✓-007ACC.svg)](https://www.typescriptlang.org)
[![Downloads](https://img.shields.io/npm/dw/opena-cli.svg)](https://npmjs.com/package/opena-cli)

> 🚀 cross-platform opener with command directory url support

# ✨ Features

* 🚀 **Cross-platform Support** - Works on Windows, macOS, and Linux
* 📁 **Smart Detection** - Automatically recognizes files, directories, URLs, and ports
* ⚡ **Quick Launch** - Preset configurations for one-click access to frequently used projects
* 🔧 **Extensible** - Supports custom application associations
* 🎯 **Terminal Integration** - Built-in terminal management capabilities
* 📊 **Preset Management** - Easy creation and management of custom shortcuts
* 🔄 **Auto-refresh** - Automatic terminal and system explorer refresh capabilities

# 📦 Installation

## install globally

```bash
pnpm install opena-cli -g
# or
bun install opena-cli -g
# or
npm install opena-cli -g
# or
yarn install opena-cli -g
```

## verify installation

```bash
opena --version
```

# 🚀 Usage

## open

Open targets (command, directory, file, URL, port or preset)

```bash
# Open bun documentation in default browser
opena open bun
# Open current directory in file explorer
opena open .
# Open parent directory in file explorer
opena open ..
# Open localhost:3000 in default browser
opena open 3000
# Open example.com website in default browser
opena open https://example.com
# Open desktop directory in file explorer
opena open desktop
# Open current directory in Visual Studio Code
opena open --app=code .
# Show help information for open command
opena open --help
```

## preset

Manage presets

```bash
# List all available presets
opena preset ls
# Add a new preset with specified name, type and target
opena preset add <name> <type> <target>
# Remove a preset by name
opena preset rm <name>
# Edit an existing preset by name
opena preset edit <name>
```

## terminal

### list

Display all detected terminals with installation and running status

```bash
# Display all terminals with their installation and running status
opena terminal list
```

### refresh

Refresh terminal instances

```bash
# Refresh all available terminal instances
opena terminal refresh
# Refresh Windows Terminal instance
opena terminal refresh --name wt
# Refresh PowerShell instance
opena terminal refresh --name ps
# Refresh Command Prompt instance
opena terminal refresh --name cmd
# Refresh Git Bash instance
opena terminal refresh --name git-bash
# Refresh WSL instance
opena terminal refresh --name wsl
```

## refresh

Refresh Windows Explorer (Windows only)

```bash
# Restart Windows Explorer to refresh desktop and file explorer
opena refresh
```

## update

Check for CLI updates

```bash
# Check and apply available updates
opena upgrade
# Turn off automatic update checks
opena upgrade --off=true
# Turn on automatic update checks
opena upgrade --off=false
# Check for updates without applying them
opena upgrade --check-only
```

# ⚙️ Config

# 💎 Show your support

Give a ⭐️ if this project helped you!