What EggseCute can do

EggseCute is a local-first catalog for operational scripts. Everything below runs on your computer unless you explicitly upload scripts to EggseCute Cloud.

Scripts

• Types: Bash, PowerShell, Python, Java, JavaScript, C#, SQL, and text snippets.
• Each script lives in a notebook, has tags and a description, and keeps versioned content.
• Delete a version from the script menu. A script keeps at least one version. If you delete the default, the newest remaining version becomes the default. Run history for that version stays and is marked deleted.
• Parameter sets store named values you can reuse on a run.
• Run history stays on the machine that executed the script.

Catalog

• Hierarchy: team → library → notebook → scripts.
• A fresh install creates Personal / General / General. You can delete General library or notebook; they are not recreated. The Personal team cannot be deleted.
• Deleting a library removes its notebooks and scripts. Deleting a notebook removes its scripts. The UI asks before it does this.

Schedules

• Build workflows of ordered steps. Each step runs a catalog script (optionally pinned to a version) with its own run environment.
• Gate steps with conditions: always, previous succeeded/failed, exit code equals/not equals, or output/error contains text.
• Triggers: interval (minutes), daily, weekly (selected weekdays), or a one-shot time.
• Schedules run only while the EggseCute process is alive — including when the window is closed and the app stays in the tray / Dock. They pause when you Force Quit.
• Manage schedules and inspect a diagram of steps and conditions in the Schedules UI. Run history is kept per schedule.

Runtimes

• Local process, or Docker with EggseCute-managed images.
• Docker images can be decorated with OS packages, pip packages, and catalog decorators.

Credentials

• Save AWS, OCI, GCP, and Azure credentials in the app.
• Select them when you run so environment variables and key files are injected for that run only.
• These secrets are not written to an export file and are not uploaded to EggseCute Cloud.

Background app

• Close or Exit keeps EggseCute running so shortcuts and schedules still work.
• Force Quit warns before terminating the process.

Backup

Preferences → Import / Export can write a full JSON snapshot, Personal only, or a single team. Cloud credentials and session tokens are omitted. Full import replaces catalog, settings, and Docker image options after a warning. Personal and team import leave the rest of the catalog in place.