@proxysoul/soulforge 2.4.0 → 2.6.5

package/README.md

@@ -118,6 +118,10 @@ SoulForge already knows. On startup it builds a **live dependency graph** of you
 <td>Installable skills for domain work. Destructive actions need confirmation. Auto mode for full autonomy.</td>
 </tr>
 <tr>
+<td><strong>Inline images</strong></td>
+<td>Pixel-perfect images, animated GIFs, and video-to-GIF inline in chat via <code>soul_vision</code>. Kitty graphics protocol with Unicode placeholders. Supports local files, URLs, and code execution output. <a href="#inline-image-support">See terminal support</a></td>
+</tr>
+<tr>
 <td><strong>4-tier intelligence</strong></td>
 <td>LSP, ts-morph, tree-sitter, regex. 33 languages. Dual LSP: Neovim bridge when the editor is open, standalone servers when it's not. <a href="docs/architecture.md">More</a></td>
 </tr>
@@ -133,6 +137,99 @@ SoulForge already knows. On startup it builds a **live dependency graph** of you
 
 <img src="assets/separator.svg" width="100%" height="8" />
 
+### Inline image support
+
+The `soul_vision` tool renders images and videos directly in chat. Pixel-perfect on supported terminals, high-quality terminal art everywhere else. Videos are converted to animated GIF via ffmpeg (two-pass palette encoding).
+
+<table>
+<thead>
+<tr>
+<th width="140">Terminal</th>
+<th width="120">Static images</th>
+<th width="120">Animated GIF</th>
+<th width="120">Video to GIF</th>
+<th>Method</th>
+<th>Notes</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Kitty</strong></td>
+<td>Pixel-perfect</td>
+<td>Animated</td>
+<td>Animated</td>
+<td>Kitty graphics protocol + Unicode placeholders</td>
+<td>Full support, the gold standard</td>
+</tr>
+<tr>
+<td><strong>Ghostty</strong></td>
+<td>Pixel-perfect</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Kitty graphics protocol + Unicode placeholders</td>
+<td>Animation not yet implemented (<a href="https://github.com/ghostty-org/ghostty/discussions/5218">#5218</a>)</td>
+</tr>
+<tr>
+<td><strong>Konsole</strong></td>
+<td>chafa / half-block</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Terminal art (chafa, built-in half-block)</td>
+<td>Has Kitty graphics but no Unicode placeholders (<a href="https://invent.kde.org/utilities/konsole/-/merge_requests/594">MR #594</a>)</td>
+</tr>
+<tr>
+<td><strong>iTerm2</strong></td>
+<td>chafa / half-block</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Terminal art (chafa, built-in half-block)</td>
+<td>Has Kitty graphics but no Unicode placeholders (<a href="https://github.com/gnachman/iTerm2/commit/4fe5b21">commit</a>)</td>
+</tr>
+<tr>
+<td><strong>WezTerm</strong></td>
+<td>chafa / half-block</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Terminal art (chafa, built-in half-block)</td>
+<td>No Unicode placeholders (<a href="https://github.com/wezterm/wezterm/issues/986">#986</a>)</td>
+</tr>
+<tr>
+<td><strong>Warp</strong></td>
+<td>chafa / half-block</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Terminal art (chafa, built-in half-block)</td>
+<td>No Unicode placeholders (<a href="https://github.com/warpdotdev/Warp/issues/6210">#6210</a>)</td>
+</tr>
+<tr>
+<td><strong>Alacritty</strong></td>
+<td>chafa / half-block</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Terminal art (chafa, built-in half-block)</td>
+<td>No graphics protocol</td>
+</tr>
+<tr>
+<td><strong>Others</strong></td>
+<td>Half-block art</td>
+<td>Static frame</td>
+<td>Static frame</td>
+<td>Built-in half-block ANSI art</td>
+<td>Any truecolor terminal works</td>
+</tr>
+</tbody>
+</table>
+
+<sub>
+<b>Formats:</b> PNG, JPG, WebP, GIF, BMP, TIFF, MP4, MKV, WebM, AVI, MOV. Non-PNG images auto-converted via <code>ffmpeg</code>, <code>sips</code> (macOS), or ImageMagick. Videos converted to GIF with two-pass palette encoding (fps capped, scaled to 320px width).
+<br/>
+Install <a href="https://github.com/hpjansson/chafa"><code>chafa</code></a> for higher quality terminal art on non-pixel terminals. Install <a href="https://github.com/FFmpeg/FFmpeg"><code>ffmpeg</code></a> for animated GIF, video conversion, and format support. Install <a href="https://github.com/yt-dlp/yt-dlp"><code>yt-dlp</code></a> to display videos from URLs.
+</sub>
+
+```bash
+brew install ffmpeg chafa yt-dlp
+```
+
 ## How it compares
 
 <table>
@@ -497,4 +594,4 @@ Extracting the intelligence layer into reusable packages:
 
 <div align="center">
 <sub>Built by <a href="https://github.com/proxysoul">proxySoul</a></sub>
-</div>
+</div>