diff --git a/README.md b/README.md index b488564..e34b564 100644 --- a/README.md +++ b/README.md @@ -1,59 +1,94 @@ -

- Command Center icon -

+
-

Command Center

+Command Center icon -

Your Linux workstation, under control.

+# Command Center -

- A desktop home for your repositories, Toolbox, configuration, backups, and system health.
- Built with Tauri, Rust, and JavaScript. Runs locally, with no account or cloud service. -

+### Your Linux workstation, under control. -

- Latest release - Platform: Linux - Desktop: Tauri 2 - License: MIT -

+A desktop home for your repositories, Toolbox, configuration, backups, and system health.
+Built with Tauri, Rust, and JavaScript. Runs locally, with no account or cloud service. -

- Download · - Wiki guide · - Installation · - User guide · - Contributing · - Feedback -

+Latest release +Platform: Linux +Desktop: Tauri 2 +Core: Rust +License: MIT -![Command Center dashboard showing repository status, configuration, backup, and system-health cards](docs/images/dashboard.jpg) +**[⬇️ Download](https://github.com/Commanderx-code/command-center/releases/latest)**  •  +**[📖 Wiki guide](https://github.com/Commanderx-code/command-center/wiki)**  •  +[Installation](docs/installation.md)  •  +[User guide](docs/user-guide.md)  •  +[Contributing](CONTRIBUTING.md)  •  +[Feedback](https://github.com/Commanderx-code/command-center/issues) -_Dashboard in browser preview mode with sample data. System integrations run in the desktop app._ +
-## One place for everyday workstation tasks +Command Center dashboard showing repository status, configuration, backup, and system-health cards -Command Center brings [Commander Toolbox](https://github.com/Commanderx-code/commander-toolbox) into a graphical desktop app and connects it to the tools you already use. Browse installers, review commands, manage Git repositories, and work with your existing Home Manager and Restic setup. - -| Workspace | What you can do | -| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Toolbox** | Browse 215 bundled actions through the TUI's folders and submenus. Search, save favorites, and choose Myfish, dotfiles, or application setups. | -| **Interactive terminal** | Run Toolbox actions with real keyboard input, password prompts, resizing, cancellation, and exit status. Choose an external terminal when needed. | -| **Repositories** | Inspect changes and history, stage files, review and commit staged changes, fetch, pull, push, organize projects, and open your editor, terminal, or project documentation. | -| **System Sync** | Review dotfiles changes and Home Manager generations, then build and apply your configuration. | -| **Backup & Restore** | Run your backup helpers, browse Restic snapshots, and restore files into a new folder. | -| **Configuration** | Edit Ghostty and Fastfetch through visual controls or source editors, with validation and backups. | -| **Health & Activity** | Check disk space, services, backup freshness, and repository attention items. Review commands and recorded job results. | +Dashboard in browser preview mode with sample data. System integrations run in the desktop app. -The app runs as your normal user. Commands are reviewed before execution; Toolbox scripts retain their own privilege checks and confirmations. Integration paths are editable in **Settings**. See the [user guide](docs/user-guide.md) for exact behavior and limitations. +
-## New in 0.7.0 +
-- **Backup file history:** search every backup snapshot for a file, see each saved version with its date, size and whether it changed, spot files that were deleted, and restore the version you want into a new folder. +## ✨ One place for everyday workstation tasks -Read [Backup file history](docs/user-guide.md#backup-file-history) in the user guide. +Command Center brings [Commander Toolbox](https://github.com/Commanderx-code/commander-toolbox) into a graphical desktop app and connects it to the tools you already use. Browse installers, review commands, manage Git repositories, and work with your existing Home Manager and Restic setup. -## New in 0.6.0 + + + + + + + + + + + + + + + + +
+

🧰 Toolbox

+ Browse 215 bundled actions through the TUI's folders and submenus. Search, save favorites, and choose Myfish, dotfiles, or application setups. + 		+

💻 Interactive terminal

+ Run Toolbox actions with real keyboard input, password prompts, resizing, cancellation, and exit status. Choose an external terminal when needed. +
+

📂 Repositories

+ Inspect changes and history, stage files, review and commit staged changes, fetch, pull, push, organize projects, and open your editor, terminal, or project documentation. + 		+

🔄 System Sync

+ Review dotfiles changes and Home Manager generations, then build and apply your configuration. +
+

🗄️ Backup & Restore

+ Run your backup helpers, browse Restic snapshots, and restore files into a new folder. + 		+

🎛️ Configuration

+ Edit Ghostty and Fastfetch through visual controls or source editors, with validation and backups. +
+

🩺 Health & Activity

+ Check disk space, services, backup freshness, and repository attention items. Review commands and recorded job results. +
+ +> [!NOTE] +> The app runs as your normal user. Commands are reviewed before execution; Toolbox scripts retain their own privilege checks and confirmations. Integration paths are editable in **Settings**. See the [user guide](docs/user-guide.md) for exact behavior and limitations. + +## 🚀 What's new + +### 0.7.0 — Backup file history + +Search every backup snapshot for a file, see each saved version with its date, size and whether it changed, spot files that were deleted, and restore the version you want into a new folder. + +→ Read [Backup file history](docs/user-guide.md#backup-file-history) in the user guide. + +
+0.6.0 — safer setup imports, parallel jobs, wider distro support +
- Setup imports can merge with this machine's setup, and an import interrupted by a crash or power loss is rolled back automatically on the next launch. - Jobs in different repositories run at the same time, alongside one workstation task. @@ -62,7 +97,11 @@ Read [Backup file history](docs/user-guide.md#backup-file-history) in the user g Read [Setup and project workspaces](docs/setup-and-workspaces.md) and [Running several jobs](docs/user-guide.md#running-several-jobs). -## New in 0.5.0 +
+ +
+0.5.0 — portable setups and project workspaces +
- Portable setup bundles with a full import preview, home-path remapping, and backups before replacement. - A first-run wizard for existing Commander-os/Home Manager and Restic connections. @@ -71,7 +110,11 @@ Read [Setup and project workspaces](docs/setup-and-workspaces.md) and [Running s Read [Setup and project workspaces](docs/setup-and-workspaces.md) for setup, import behavior, and task execution. -## New in 0.4.0 +
+ +
+0.4.0 — workflows, profiles, and recovery verification +
- Guided maintenance workflows and local machine setup profiles. - Personal Toolbox folders with prerequisites and structured inputs. @@ -82,30 +125,36 @@ Read [Setup and project workspaces](docs/setup-and-workspaces.md) for setup, imp Read [Workflows, profiles, and recovery verification](docs/operations.md) for setup and behavior. -## Download and install +
+ +Full history lives in the [changelog](CHANGELOG.md). + +## 📦 Download and install **[Get the latest release →](https://github.com/Commanderx-code/command-center/releases/latest)** -| Package | Download v0.7.1 | Install the downloaded file | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | -| Debian / Ubuntu | [`.deb` · amd64](https://github.com/Commanderx-code/command-center/releases/download/v0.7.1/command-center_0.7.1_amd64.deb) | `sudo apt install ./command-center_0.7.1_amd64.deb` | -| Fedora / RPM | [`.rpm` · x86_64](https://github.com/Commanderx-code/command-center/releases/download/v0.7.1/command-center-0.7.1-1.x86_64.rpm) | `sudo dnf install ./command-center-0.7.1-1.x86_64.rpm` | +| Package | Download v0.7.1 | Install the downloaded file | +| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | +| Debian / Ubuntu | [`.deb` · amd64](https://github.com/Commanderx-code/command-center/releases/download/v0.7.1/command-center_0.7.1_amd64.deb) | `sudo apt install ./command-center_0.7.1_amd64.deb` | +| Fedora / RPM | [`.rpm` · x86_64](https://github.com/Commanderx-code/command-center/releases/download/v0.7.1/command-center-0.7.1-1.x86_64.rpm) | `sudo dnf install ./command-center-0.7.1-1.x86_64.rpm` | | Arch / Garuda | [`.pkg.tar.zst` · x86_64](https://github.com/Commanderx-code/command-center/releases/download/v0.7.1/command-center-0.7.1-1-x86_64.pkg.tar.zst) | `sudo pacman -U ./command-center-0.7.1-1-x86_64.pkg.tar.zst` | -Version 0.7.1 packages require **Linux x86_64, glibc 2.35+, GTK 3, and WebKitGTK 4.1**. They are install-tested on Ubuntu 22.04 and 24.04, Debian 12, and Fedora 43, and the Arch package on current Arch; the release notes link the workflow run. Release assets include `SHA256SUMS` for verification. +> [!IMPORTANT] +> Version 0.7.1 packages require **Linux x86_64, glibc 2.35+, GTK 3, and WebKitGTK 4.1**. They are install-tested on Ubuntu 22.04 and 24.04, Debian 12, and Fedora 43, and the Arch package on current Arch; the release notes link the workflow run. Release assets include `SHA256SUMS` for verification. Arch/Garuda users can also build the same package with `makepkg -si` from `packaging/aur/`, or develop from source using the [installation guide](docs/installation.md#from-source-on-archgaruda). -## Get started +## 🏁 Get started 1. Launch **Command Center** from your application menu. 2. Open **Settings** to choose repository scan folders, your editor, and your terminal. 3. Review **Settings → System integrations** to connect existing dotfiles, Home Manager, backup helpers, and Restic credentials. 4. Open **Toolbox** to browse folders, choose an action, and **Review & run**. -Existing integrations can be detected on first launch or with **Detect existing setup**. Missing tools are shown as unavailable. Read [Connect your setup](docs/user-guide.md#connect-your-setup) for configuration details. +> [!TIP] +> Existing integrations can be detected on first launch or with **Detect existing setup**. Missing tools are shown as unavailable. Read [Connect your setup](docs/user-guide.md#connect-your-setup) for configuration details. -## Develop locally +## 🛠️ Develop locally With a supported Node.js version and npm installed: @@ -118,21 +167,28 @@ npm run dev Open `http://127.0.0.1:4173` for a browser preview with sample data. Desktop operations require Rust and the Linux system dependencies listed in the [installation guide](docs/installation.md). See [Development](docs/development.md) for checks, architecture, and packaging. -## Documentation +## 📚 Documentation -- **[Wiki: how to use Command Center](https://github.com/Commanderx-code/command-center/wiki)**: a step-by-step guide to every page and feature, plus troubleshooting. -- [Installation](docs/installation.md) — packages, requirements, checksums, and source builds. -- [User guide](docs/user-guide.md) — features, integrations, command behavior, and local data. -- [Development](docs/development.md) — repository layout, checks, and Toolbox updates. -- [Workflows and profiles](docs/operations.md) — maintenance recipes, personal tools, recovery tests, and notifications. -- [Changelog](CHANGELOG.md) — release highlights. -- [Contributing](CONTRIBUTING.md) — bug reports, feature requests, and pull requests. -- [Third-party notices](THIRD_PARTY.md) — bundled components and their notices. +| | | +| ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | +| 📖 **[Wiki: how to use Command Center](https://github.com/Commanderx-code/command-center/wiki)** | A step-by-step guide to every page and feature, plus troubleshooting. | +| 📥 [Installation](docs/installation.md) | Packages, requirements, checksums, and source builds. | +| 🧭 [User guide](docs/user-guide.md) | Features, integrations, command behavior, and local data. | +| 🧑‍💻 [Development](docs/development.md) | Repository layout, checks, and Toolbox updates. | +| ⚙️ [Workflows and profiles](docs/operations.md) | Maintenance recipes, personal tools, recovery tests, and notifications. | +| 📝 [Changelog](CHANGELOG.md) | Release highlights. | +| 🤝 [Contributing](CONTRIBUTING.md) | Bug reports, feature requests, and pull requests. | +| 🧾 [Third-party notices](THIRD_PARTY.md) | Bundled components and their notices. | -## Built with +## 🧱 Built with [Tauri](https://github.com/tauri-apps/tauri) provides the desktop shell, Rust handles local system operations, and JavaScript renders the interface. The Toolbox catalog and scripts come from [Commander Toolbox](https://github.com/Commanderx-code/commander-toolbox), built on Linutil. [xterm.js](https://github.com/xtermjs/xterm.js) and [portable-pty](https://github.com/wezterm/wezterm) power the embedded terminal. -## License +## ⚖️ License Command Center is released under the [MIT License](LICENSE). Bundled third-party components keep their own licenses; see [THIRD_PARTY.md](THIRD_PARTY.md). + +
+
+Made for Linux desktops · Report a bug or request a feature +