better-ares-cli

A beautiful interactive TUI for webOS development — wraps ares-cli so you never have to memorize commands again.

┌─────────────────────────────────────────────────────────────────────┐
│ ⬡  WebOS Manager                          ● mydevice (192.168.1.10) │
├──────────────┬──────────────────────────────────────────────────────┤
│ Navigation   │  ◉  Dashboard                                        │
│ ▶ ◉ Dashboard│                                                      │
│   ⬡ Devices  │  ⬡ Devices            ⊕ Installed Apps [mydevice]   │
│   ✦ Generate │  ● mydevice (default) › com.example.app  v1.0.0     │
│   ⊟ Deploy   │  ○ emulator           › com.webos.app.music          │
│   ⊕ Apps     │                                                      │
│   ≡ Logs     │  Quick Actions                                       │
│   ⇄ Transfer │  ▶ [g] Generate App                                  │
│   $ Shell    │    [p] Package & Deploy                              │
│   ◎ Inspector│    [m] App Manager                                   │
│ ─────────────│    [l] Log Viewer                                    │
│ ↑↓ navigate  │    [s] Shell                                         │
│ ⏎  select    │    [d] Manage Devices                                │
└──────────────┴──────────────────────────────────────────────────────┘

Features

| Screen | What it does | |--------|-------------| | Dashboard | Device status, installed apps, quick-action shortcuts | | Devices | Add / remove / set-default devices (ares-setup-device) | | Generate App | Scaffold from any ares-generate template | | Package & Deploy | Package → install → launch in one guided flow | | App Manager | List, launch, stop, remove installed apps | | Log Viewer | Live log stream with pause / filter (ares-log -f) | | File Transfer | Push / pull files between host and device | | Shell | Run shell commands on the device with history | | Inspector | Open Web Inspector for a running app |

Requirements

• Node.js ≥ 18
• ares-cli (@webosose/ares-cli) installed and on PATH

npm install -g @webosose/ares-cli

Installation

Quick install (recommended)

curl -fsSL https://raw.githubusercontent.com/FernandoHaeser/better-ares-cli/main/install.sh | bash

Via npm

npm install -g better-ares-cli

From source

git clone https://github.com/FernandoHaeser/better-ares-cli.git
cd better-ares-cli
npm install
npm run build
npm link

Usage

betterares

That's it. The TUI opens in your terminal.

Keyboard shortcuts

| Key | Action | |-----|--------| | ↑ / ↓ | Navigate sidebar / lists | | Enter | Select / confirm | | Esc / Tab | Back to sidebar | | q (in sidebar) | Quit | | Ctrl+C | Quit anywhere |

Each screen shows its own shortcuts at the bottom.

Development

# Install dependencies
npm install

# Build & run
npm start

# Build only
npm run build

The build bundles with esbuild into dist/cli.mjs.

Contributing

1. Fork the repo
2. Create a branch: git checkout -b feat/my-feature
3. Commit and push
4. Open a pull request

See docs/RELEASE.md for the release process.

License

MIT © FernandoHaeser