Your terminal, your rules.
The AutoShelf CLI is a companion to the macOS app. Control rules, organize files, and automate workflows from the command line. Requires the AutoShelf app.
Install in one command
Skip the browser. Get the AutoShelf CLI running in under 10 seconds.
curl -fsSL https://useautoshelf.com/cli/install.sh | sh Installs to /usr/local/bin/autoshelf. Requires macOS 14+ (Apple Silicon or Intel).
What you can do
autoshelf rules list
See all your active rules at a glance. Check which folders are watched and what conditions trigger each rule.
autoshelf rules create
Create new rules from the terminal. Specify the watch folder, conditions, and actions, all from one command.
autoshelf rules run
Manually trigger a rule to organize files right now. No waiting for file events. Run it when you want, on demand.
autoshelf folders
List all watched folders and see their status. Know exactly what AutoShelf is monitoring at all times.
Quick start
# List all rules
autoshelf rules list
# Create a rule to move PDFs from Downloads to Documents
autoshelf rules create \
--watch ~/Downloads \
--condition "extension = pdf" \
--action "move ~/Documents/PDFs"
# Run a rule on demand
autoshelf rules run my-rule-name
# See all watched folders
autoshelf folders
# Get help on any command
autoshelf --help
autoshelf rules create --help
Built for developers
Scriptable
Chain commands in shell scripts. Automate onboarding, project setup, or cleanup workflows that run on cron or CI.
Fast
No GUI needed. Create a rule, run it, move on. The CLI talks directly to the AutoShelf engine on your machine.
Works with the app
The CLI is a companion to the AutoShelf app, not a standalone tool. Rules created via CLI show up in the app and vice versa. Same engine, different surface.
Offline and local
No server, no API keys, no network required. The CLI communicates with the local AutoShelf daemon over Unix sockets.
Frequently asked questions
-
Do I need the AutoShelf app to use the CLI?
Yes. The CLI is a companion tool, not a standalone app. It communicates with the local AutoShelf daemon, so the macOS app needs to be installed and running for CLI commands to work.
-
What macOS versions does the CLI support?
macOS 14 Sonoma and later, same as the app. Both Apple Silicon (arm64) and Intel (amd64) are supported.
-
Can I use the CLI in scripts or CI?
Yes. Every command returns structured output designed for scripting. Exit codes indicate success or failure, so you can chain commands reliably.
-
How is the CLI installed?
The install script downloads the correct binary for your architecture to /usr/local/bin/autoshelf. You can also download the tarball directly from the links below.
-
Is the CLI open source?
The CLI binary is free to use.