SwiftButler

Use butler to reduce Swift source into a more manageable working surface.

Setup

Install via Homebrew:

CODEBLOCK0

Verify:

CODEBLOCK1

For local development from a checkout:

CODEBLOCK2

Core Rules

• - Prefer analyze when an agent needs API shape, not full implementation details.
• Prefer --format yaml or --format json when the result will be parsed or reused.
• Prefer check for fast validation loops before swift build.
• Use reindent to normalize indentation in place; choose exactly one of --spaces <n> or --tabs.
• Use distribute before targeted edits when a generated file has become too large or noisy.

Fast Command Map

Analyze Swift APIs

Supported formats:

• - INLINECODE10
• INLINECODE11
• INLINECODE12
• INLINECODE13

Syntax-check Swift quickly

Reindent with spaces or tabs

Notes:

• - --spaces <n> accepts values from 1 to 16.
• INLINECODE17 and --spaces <n> are mutually exclusive.
• Without --tabs, the default is --spaces 3.

Distribute large files into smaller ones

When to Use Which Command

• - Use analyze to hand an LLM a compact view of types, functions, properties, and docs.
• Use check inside generation or repair loops for immediate syntax feedback.
• Use reindent after generated or patched code has inconsistent indentation.
• Use distribute when one large Swift file should become declaration-sized files that are easier to inspect and edit.