# Charm Freeze

> Generate PNG, SVG, or WebP screenshots of code and terminal output with freeze. Use when screenshotting code, freeze, terminal-to-image, or capturing styled code snippets as images.

- **Type:** Skill
- **Install:** `agentstack add skill-alxxpersonal-forge-charm-freeze`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [alxxpersonal](https://agentstack.voostack.com/s/alxxpersonal)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [alxxpersonal](https://github.com/alxxpersonal)
- **Source:** https://github.com/alxxpersonal/forge/tree/main/skills/charm-freeze

## Install

```sh
agentstack add skill-alxxpersonal-forge-charm-freeze
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# charm-freeze

Generate images of code and terminal output using `freeze`.

## Basic Usage

```bash
# screenshot a file (auto-detects language)
freeze main.go -o main.png

# pipe code in
cat artichoke.hs | freeze -o out.svg

# capture live terminal command output
freeze --execute "eza -lah" -o eza.png
```

## Output Formats

Default output is `freeze.png`. Supports `.svg`, `.png`, `.webp`.

```bash
freeze main.go -o out.svg
freeze main.go -o out.png
freeze main.go -o out.webp

# all at once
freeze main.go -o out.{svg,png,webp}
```

If piped (e.g. `freeze main.go > out.svg`), outputs to stdout.

## Language Detection

Auto-detects from filename or content. Override with `--language`:

```bash
cat script.sh | freeze --language bash
freeze file.txt --language python
```

## Themes

```bash
freeze main.go --theme dracula
freeze main.go --theme charm       # default
freeze main.go --theme github
```

## Fonts

Defaults: JetBrains Mono, 14px, 1.2 line-height.

```bash
freeze main.go \
  --font.family "SF Mono" \
  --font.size 16 \
  --line-height 1.4

# embed a font file (TTF, WOFF, WOFF2)
freeze main.go --font.file ./FiraCode.ttf

# enable ligatures
freeze main.go --font.ligatures
```

## Decorations

```bash
# window controls (macOS style)
freeze main.go --window

# rounded corners
freeze main.go --border.radius 8

# border outline
freeze main.go --border.width 1 --border.color "#515151" --border.radius 8

# drop shadow
freeze main.go --shadow.blur 20 --shadow.x 0 --shadow.y 10

# background color
freeze main.go --background "#08163f"
```

## Layout

```bash
# padding (1, 2, or 4 values)
freeze main.go --padding 20
freeze main.go --padding 20,40
freeze main.go --padding 20,60,20,40   # top right bottom left

# margin (same syntax)
freeze main.go --margin 20,40

# fixed height
freeze main.go --height 400
```

## Line Numbers

```bash
freeze main.go --show-line-numbers

# capture specific lines only
freeze main.go --show-line-numbers --lines 10,25
```

## Configurations

Three built-in presets:

```bash
freeze -c base main.go    # minimal
freeze -c full main.go    # macOS-like, shadow + window controls
freeze -c user main.go    # your saved config (~/.config/freeze/user.json)

# custom JSON config
freeze -c ./custom.json main.go
```

Example `custom.json`:

```json
{
  "window": true,
  "border": { "radius": 8, "width": 1, "color": "#515151" },
  "shadow": { "blur": 20, "x": 0, "y": 10 },
  "padding": [20, 40, 20, 20],
  "font": { "family": "JetBrains Mono", "size": 14 },
  "line_height": 1.2
}
```

## Interactive Mode

```bash
freeze --interactive
```

Opens a TUI to tweak all settings visually. Saves result to `~/.config/freeze/user.json`.

## Screenshot TUIs

Capture a running TUI via tmux:

```bash
tmux capture-pane -pet 1 | freeze -c full -o helix.png
```

## Wrap Long Lines

```bash
freeze main.go --wrap 80
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [alxxpersonal](https://github.com/alxxpersonal)
- **Source:** [alxxpersonal/forge](https://github.com/alxxpersonal/forge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-alxxpersonal-forge-charm-freeze
- Seller: https://agentstack.voostack.com/s/alxxpersonal
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.