Bake

Bake is a CLI automation orchestrator for managing internal tool repositories, setup scripts, and reusable command workflows.

Why Bake

• Organize automation in one place instead of scattered shell scripts.
• Bootstrap and install tool repositories from JSON definitions.
• Expose runnable binaries in a shared bin directory.
• Keep local setup repeatable across developers.

Install

Install Bake as a global CLI tool with uv:

uv tool install bake

Or install from a local checkout for development:

uv venv
source .venv/bin/activate
uv pip install -e .

After installation, the bake command is available globally:

bake

Commands

bake install

Interactive initialization flow that:

• Configures BAKE_PATH in .env.
• Creates config, repositories, and bin folders.
• Copies default configuration templates from tools/config.
• Optionally downloads and installs configured repositories.

bake tray

Opens an interactive terminal UI to browse and run installed commands from $BAKE_PATH/bin. Navigate with arrow keys and press Enter to execute.

The UI theme can be configured via the BAKE_THEME environment variable in .env (defaults to nord). Available themes: gruvbox, tokyo-night, textual-dark, solarized-light, atom-one-dark, atom-one-light.

bake dpkg sync-config

Synchronizes default configuration definitions from tools/config into $BAKE_PATH/config.

Configuration Model

Bake uses JSON files in tools/config, for example:

{
  "name": "aws-cli-toolkit",
  "repo_url": "https://github.com/darioriverat/aws-cli-toolkit",
  "description": "A comprehensive command-line toolkit for managing AWS services",
  "scripts": {
    "install": [
      "uv venv",
      "source .venv/bin/activate",
      "uv pip install -e ."
    ]
  }
}

Optional binaries entries can create symlinks/wrappers in $BAKE_PATH/bin.

Notes

• BAKE_PATH is the environment variable used by Bake.
• bake is the canonical command.