DockAmi Documentation

Complete reference for DockAmi — the macOS Dock profile manager.

What is DockAmi?

DockAmi is a macOS utility that lets you create, save, and switch between multiple Dock profiles. Instead of manually rearranging your Dock for different workflows (e.g. development, design, communication), DockAmi lets you define named profiles and switch between them instantly — via the GUI or the command-line interface.

Use cases include: keeping a minimal Dock for focused work, switching to a full Dock for multitasking, setting up project-specific Docks, or automating Dock layout changes with scripts.

Installation

Homebrew (recommended)

brew install --cask dockami

Direct download

Download the latest .dmg from dockami.app, open it, and drag DockAmi to your Applications folder.

CLI Reference

DockAmi ships with a command-line tool dockami-cli that is installed automatically. It allows you to manage Dock profiles from the terminal or from scripts and automation tools.

dockami-cli list

List all saved Dock profiles. Prints one profile name per line.

$ dockami-cli list
Work
Personal
Minimal
Design

dockami-cli current

Print the name of the currently active Dock profile.

$ dockami-cli current
Work

dockami-cli apply <name>

Apply a saved Dock profile by name. This replaces your current Dock contents with the apps defined in the profile and restarts the Dock.

$ dockami-cli apply Minimal

Examples

Switch profile in a shell script:

#!/bin/bash
# Switch to "Work" Dock when starting a dev session
dockami-cli apply Work

Check current profile before switching:

current=$(dockami-cli current)
if [ "$current" != "Minimal" ]; then
  dockami-cli apply Minimal
fi

GUI Features

  • Dock Profiles — Save unlimited named Dock configurations. Each profile stores the list of apps and their order.
  • One-Click Switching — Switch between profiles instantly from the menu bar or the main window.
  • Keyboard Shortcuts — Assign global keyboard shortcuts to your favorite profiles for instant switching.
  • Import / Export — Export profiles as files to share with teammates or back up your configurations.
  • Menu Bar Access — Quick access to all profiles from the macOS menu bar without opening the main window.

System Requirements

  • macOS 14.0 (Sonoma) or later
  • Apple Silicon (M1 or later)

Links