CLIManager

CLIManager is a lightweight macOS app to organize and run commands across many local projects from one place. It is designed for people who constantly hop between directories and want a single, simple control panel to start/stop tasks and view logs.

Features

• Track multiple projects with name, path, and start command
• Start/stop processes and see their running status
• Auto-detect processes started outside the app and keep their status in sync
• View logs in-app with selectable text; processes started by CLIManager keep their status and logs across app restarts
• Check for app updates from the menu (powered by Sparkle)
• Stores data locally in Application Support

Usage

1. Add a project with:
   • Name
   • Path (must exist and be a directory)
   • Start Command (for example: npm run dev)
2. Select a project to view details and logs.
3. Use Start / Stop to control the process.

CLI Import API

CLIManager also exposes a CLI entrypoint for automation:

swift run CLIManagerCLI import --path /absolute/path/to/project

To install the global climanager command from a source checkout:

swift run CLIManagerCLI install-cli

Optional flags:

• --name "Custom Name"
• --command "npm run dev"
• --dry-run
• install-cli --target ~/bin/climanager

The command prints a JSON result with:

• action: created, unchanged, or preview
• project: the registered project record
• projectsFile: the projects.json path used

Inside the app, use the Automation toolbar button to view the import command, copy it, and reveal the CLIManager data location in Finder. The same panel can install the bundled climanager command and the app will auto-refresh when external imports update projects.json.

Skill

This repo also ships the climanager-register-project skill for agent ecosystems such as skills.sh.

Install from GitHub with:

npx skills add https://github.com/snowshadow/CLIManager.git --skill climanager-register-project

Releasing

scripts/release.sh            # patch bump  (v2.0.3 → v2.0.4)
scripts/release.sh minor      # minor bump  (v2.0.3 → v2.1.0)
scripts/release.sh major      # major bump  (v2.0.3 → v3.0.0)
scripts/release.sh 2.5.0      # exact version

The script builds and tests, commits any staged changes, tags the release, and pushes — then CI builds the DMG and publishes the GitHub Release.

Build & Run

Requirements:

• macOS 13+
• Swift 6

Build:

swift build

Run the app:

swift run CLIManagerApp

Run tests:

swift test

Data Storage

Data is stored in:

~/Library/Application Support/CLIManager/

Files:

• projects.json
• runtime_state.json
• logs/

License

MIT