futzer

Generate Zsh configuration files from TOML profiles and source them into .zshrc.

2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/samdengler/guppi-skills --skill futzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: futzer
Source: https://github.com/samdengler/guppi-skills/tree/main/futzer
Command: npx skills add https://github.com/samdengler/guppi-skills --skill futzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typer>=0.9.0, rich>=14.0.0, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation and management of shell configuration files, ensuring consistency across multiple machines and simplifying setup.

Core Features & Use Cases

  • Config Generation: Creates opinionated zsh configuration files with sensible defaults.
  • Profile Management: Allows a single configuration to adapt to different environments (e.g., home, work) using profiles.
  • Dotfile Management: Wires generated configurations into your .zshrc automatically, simplifying dotfile maintenance.
  • Use Case: When setting up a new laptop, use Futzer to quickly apply your preferred shell environment by running a single command.

Quick Start

Apply your shell configuration across all your machines using the futzer skill.

Frequently Asked Questions about futzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate zsh configuration across multiple machines?

Automating zsh configuration across multiple machines involves generating opinionated shell profiles and sourcing them directly into your `.zshrc`. This Skill creates configuration files in `~/.config/guppi/futzer/` to ensure consistency and simplify setup across different environments.

What is the best way to manage different shell profiles for home and work?

Managing different shell profiles for home and work is handled through a TOML-based profile system. This approach allows a single configuration to adapt to different environments, applying specific settings and variables depending on the active profile context.

How do I generate dotfiles and wire them into my shell automatically?

Generating dotfiles and wiring them into your shell is achieved by creating opinionated zsh configuration files with sensible defaults. The Skill automatically sources these generated configurations into your `.zshrc`, simplifying ongoing dotfile maintenance.

Do I need Python dependencies to use this zsh configuration generator?

Python dependencies are required to use this zsh configuration generator. You need `typer` (version 0.9.0 or higher) for command-line interface management and `rich` (version 14.0.0 or higher) for terminal formatting to execute the generation scripts.

Can I use this tool to set up a new laptop shell environment quickly?

You can use this tool to quickly set up a new laptop shell environment by running a single command. It applies your preferred shell environment by generating the necessary configuration files and automatically linking them to your active shell configuration.

Why use a TOML-based profile system for shell configuration?

Using a TOML-based profile system for shell configuration provides a structured, easy-to-read format for managing environment-specific variables. It enables seamless adaptation between different machines, ensuring the correct settings are applied without manually editing dotfiles.