Skip to content
Back to search

washi

Grainy, textured gradient backgrounds as PNG: CLI and MCP server in Rust

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Idered/washi with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Idered/washi'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/idered--washi/badge.svg)](/listings/idered--washi)

HTML

<a href="/listings/idered--washi"><img src="/api/listings/idered--washi/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Build and install with [Cargo](https://rustup.rs):

cargo install --git https://github.com/Idered/washi

This puts `washi` and `washi-mcp` in `~/.cargo/bin`. To add the server to Claude Code:

claude mcp add -s user washi -- ~/.cargo/bin/washi-mcp

Other MCP clients take the same command in their config:

{ "mcpServers": { "washi": { "command": "/Users/you/.cargo/bin/washi-mcp" } } }

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 152 lines
  1. # washi
  2. Grainy, textured gradient backgrounds, rendered as PNG. Named after the fibrous Japanese paper.
  3. washi is two programs from one Rust crate:
  4. - `washi`, a command-line tool
  5. - `washi-mcp`, an MCP server, so Claude and other MCP clients can generate backgrounds
  6. ```bash
  7. washi aurora out.png -p borealis
  8. washi sky storm.png -p storm --rain 1 --noise 8
  9. washi sheet types.png -p peach # every type side by side
  10. ```
  11. ## Examples
  12. | | |
  13. |---|---|
  14. | ![aurora](docs/aurora.png) | ![dunes](docs/dunes.png) |
  15. | `washi aurora out.png -p borealis` | `washi dunes out.png -p sunset` |
  16. | ![warp](docs/warp.png) | ![glow](docs/glow.png) |
  17. | `washi warp out.png -p amethyst` | `washi glow out.png -p deep-sea` |
  18. | ![storm](docs/storm.png) | ![sand](docs/sand.png) |
  19. | `washi sky out.png -p storm -d none --noise 8 --scale 52 --warp 62 --wind 58 --rain 1` | `washi grainy out.png -p citrus --grain-size 2 --grain 0.05` |
  20. These are shown at 800×450. The commands render at the default 1920×1080 with the same layout.
  21. ## Install
  22. Build and install with [Cargo](https://rustup.rs):
  23. ```bash
  24. cargo install --git https://github.com/Idered/washi
  25. ```
  26. This puts `washi` and `washi-mcp` in `~/.cargo/bin`. To add the server to Claude Code:
  27. ```bash
  28. claude mcp add -s user washi -- ~/.cargo/bin/washi-mcp
  29. ```
  30. Other MCP clients take the same command in their config:
  31. ```json
  32. { "mcpServers": { "washi": { "command": "/Users/you/.cargo/bin/washi-mcp" } } }
  33. ```
  34. ## Types
  35. | Type | Look |
  36. |---|---|
  37. | `mesh` | Soft color points blended into each other |
  38. | `sky` | Clouds over a deep sky, with grain only on the cloud edges |
  39. | `grainy` | Wavy bands of light; best with `--grain-size 2` |
  40. | `flow` | Swirling clouds across the whole palette |
  41. | `prism` | Stepped vertical bands glowing from the bottom |
  42. | `glow` | Large arcs with a glowing edge |
  43. | `warp` | Marbled, silky streaks |
  44. | `dunes` | Layered hills with soft, ragged edges |
  45. | `aurora` | Curtains of light with rays and stars |
  46. | `rings` | Concentric rings from a corner |
  47. | `bars` | Blurred columns of light rising from the bottom |
  48. ## Palettes
  49. Each palette is 4–6 shades of one color family. Colors are blended in OKLab, so transitions stay clean instead of turning grey.
  50. | Group | Palettes |
  51. |---|---|
  52. | Dark | `evening` (default), `night`, `dawn`, `borealis`, `amethyst`, `deep-sea`, `graphite` |
  53. | Skies | `blue-sky`, `storm`, `night-sky`, `snow` |
  54. | Light | `lavender`, `peach`, `mint`, `glacier`, `citrus`, `rose`, `sage`, `sunset` |
  55. You can also pass your own colors in any order with `-c "#03060F,#12B886,#7048E8"`. They're sorted from dark to light.
  56. ## Options
  57. | CLI | MCP | Default | What it does |
  58. |---|---|---|---|
  59. | `-p` | `palette` | `evening` | Named palette |
  60. | `-c` | `colors` | | Custom hex colors instead of a palette |
  61. | `-W`, `-H` | `width`, `height` | 1920×1080 | Size in px (16–8192) |
  62. | `-s` | `seed` | 1 | Layout; the same seed always gives the same image |
  63. | `-d` | `dither` | `grain` | `grain` (film grain), `bayer` (retro 8×8 pattern), `none` |
  64. | `-g` | `grain` | 0.035 | Grain strength: 0.02 subtle, 0.06 strong |
  65. | `--grain-size` | `grain_size` | 1 | Grain size in px; 2–3 is coarser |
  66. | `--noise` | `noise` | 0 | Grey overlay noise, in % |
  67. | `--shade` | `shade` | `none` | Darken under content: `left`, `bottom`, `center` |
  68. | `--rotate` | `rotate` | 0 | Rotate the layout: 0, 90, 180, 270 |
  69. | `--exposure` | `exposure` | 1 | Brightness before tonemapping |
  70. | `--tonemap` | `tonemap` | per type | `none`, `reinhard`, `aces` |
  71. | `--stars` | `stars` | aurora only | Star density |
  72. | `--rain` | `rain` | 0 | Rain streaks: 0.5 light, 1.5 downpour |
  73. | `--snow` | `snow` | 0 | Snowflakes: 0.5 flurries, 1.5 blizzard |
  74. | `--scale`, `--warp`, `--wind` | same | 45, 50, 40 | `sky` only: cloud size, distortion, wind (in %) |
  75. | `--time` | `start_t` | from seed | `sky` only: animation frame |
  76. Some combinations that work well:
  77. ```bash
  78. washi sky storm.png -p storm -d none --noise 8 --scale 52 --warp 62 --wind 58 --rain 1
  79. washi sky night.png -p night-sky --rotate 180 --exposure 0.45 --stars 0.7
  80. washi sky snow.png -p snow --snow 1
  81. washi grainy sand.png -p citrus --grain-size 2 --grain 0.05
  82. washi mesh tv.png -p night --shade left
  83. ```
  84. ## MCP tools
  85. | Tool | What it does |
  86. |---|---|
  87. | `generate_gradient` | Renders a background, saves the PNG and returns its path with a small preview |
  88. | `preview_types` | A sheet comparing types in one palette |
  89. | `preview_seeds` | A sheet comparing seeds for one type |
  90. | `list_types` | Types with descriptions |
  91. | `list_palettes` | Palettes with their colors |
  92. Images are saved to `~/Pictures/washi`, or to `$WASHI_OUT` if it's set. Each call creates a new timestamped file there unless you pass `output_path`:
  93. - It must end in `.png`.
  94. - Relative paths are resolved inside the output folder.
  95. - An existing PNG at that path is replaced, but any other existing file is never overwritten.
  96. Every parameter has a description and limits in the tool schema, and the server enforces the same limits. Unknown arguments are rejected instead of ignored. Results include a text summary, a downscaled JPEG preview and, for clients on protocol 2025-06-18 or newer, a `resource_link` to the saved PNG.
  97. ## How it works
  98. Each type computes a color field at up to 1280 px wide, which is then scaled to the final size. After that come exposure, tonemapping, sRGB conversion, shading, stars and weather, and finally grain or dithering. A faint 1-bit dither is always added so smooth gradients don't band in 8-bit PNGs.
  99. The MCP server speaks JSON-RPC over stdio directly, without an SDK or async runtime. It uses about 2 MB while idle, including after large renders.
  100. | File | Contents |
  101. |---|---|
  102. | `src/core.rs` | Types, palettes, color math and the render pipeline |
  103. | `src/rng.rs` | Random number generator (a port of numpy's PCG64, so seeds match the original Python version) |
  104. | `src/sheet.rs` | Comparison sheets with labels |
  105. | `src/bin/washi.rs` | CLI |
  106. | `src/bin/washi-mcp.rs` | MCP server |
  107. ## Development
  108. ```bash
  109. cargo test --release # image checks (seeds still render the same) and MCP protocol tests
  110. cargo build --release
  111. ```
  112. To release, bump `version` in `Cargo.toml`, commit, and push a matching tag (`git tag v0.2.0 && git push origin v0.2.0`). The Release workflow builds every platform and stages the npm packages: `washi-mcp` and one `washi-mcp-<platform>` package per platform, holding its binaries. Staged packages go public once you approve them with 2FA on npmjs.com (Account > Staged Packages). The workflow authenticates with an `NPM_TOKEN` repository secret, a granular token with "Read and write (stage only)" access, or with npm trusted publishing once that's set up.
  113. ## License
  114. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.