Favorite Commands¶
Save, organize, and quickly run your frequently used commands!
The Favorites feature lets you save commands you run regularly, so you can execute them with a single click instead of setting them up every time.
Getting Started¶
Saving a Command as Favorite¶
- In the Scripts tab, set up your command:
- Select a script from the dropdown
- Enter any arguments
-
(Optional) Enter a session name
-
Click the "Save as Favorite" button (⭐)
-
A dialog will appear asking for a name for your favorite:
- Enter a descriptive name (e.g., "deploy", "backup", "daily-report")
- Click Save
That's it! Your favorite is now saved and ready to use.
Running a Favorite¶
-
Click the Favorites tab in the dashboard
-
Find your favorite in the list
-
Click the ▶️ Run button to execute the command
The command will:
- Start a new tmux session with the name fav-{your-favorite-name}
- Automatically increment the usage counter
- Appear in your sessions list
Managing Favorites¶
Search¶
Use the search box at the top of the Favorites tab to filter by: - Favorite name - Command content
Edit¶
- Click the ✏️ Edit button on any favorite
- Update the name or command
- Click Save
Delete¶
- Click the 🗑️ Delete button on any favorite
- Confirm the deletion
- Your favorite is removed
Favorite Statistics¶
For each favorite, you'll see: - Usage count: How many times you've run this favorite - Last used: When this favorite was last executed (if ever)
The Favorites tab sorts commands by most-used first, so your go-to commands appear at the top.
Features¶
✅ Persistent storage - All favorites are saved in Redis and survive application restarts
✅ Quick search - Filter favorites by name or command content
✅ Usage tracking - See which commands you use most
✅ Duplicate prevention - Can't accidentally create two favorites with the same name
✅ Full command preservation - Saves the complete execution command with all arguments
✅ Named sessions - Each favorite execution gets a descriptive session name
Examples¶
Save a Deploy Command¶
- Select
deploy.shscript - Add arguments:
--production --verify - Name it: "deploy-prod"
- Click "Save as Favorite"
Later, just click the Run button to deploy to production with one click!
Save a Data Processing Pipeline¶
- Select
process.pyscript - Add arguments:
--input=/data/raw --output=/data/processed --format=csv - Name it: "process-daily"
- Click "Save as Favorite"
Save a Health Check¶
- Select
health-check.shscript - Add arguments:
--services=api,db,cache - Name it: "check-services"
- Click "Save as Favorite"
Tips & Tricks¶
💡 Naming convention: Use descriptive names with hyphens (e.g., backup-daily, test-suite, build-prod)
💡 Edit instead of recreate: If you want to modify a command slightly, edit the favorite rather than creating a new one
💡 Search shortcuts:
- Search for python to find all Python-based favorites
- Search for --prod to find production commands
💡 Usage tracking: Check the usage count to identify which commands are actually being used vs which are rarely run
Under the Hood¶
Favorites are stored in Redis using the following structure:
- favorite_id: Unique UUID identifier
- name: User-friendly display name
- command: Full execution command
- created_at: When the favorite was created
- last_used_at: Last execution timestamp
- use_count: Number of times run
This ensures your favorites are persistent, searchable, and always available.