mAi 2a8bd4313b mAi: #5 - tmux-window preview for generate
Adds an optional `imagen generate` post-step that opens a sibling
tmux window running tmux-img --hold <path>.

- internal/preview: Mode (auto|on|off), Resolve, and a Spawner that
  shells out to tmux new-window. Typed errors for missing tmux,
  missing tmux-img, and "preview forced on outside $TMUX".
- cmd/imagen/generate: --preview / --no-preview flags plus
  $IMAGEN_PREVIEW. Resolution chain: config -> env -> flag.
  auto requires both stdout-is-tty and $TMUX. Failures are
  warnings - the image is already on disk.
- internal/config: output.preview field, validated to auto|on|off,
  threaded into the sample.
- Tests for ParseMode, Resolve, Spawn argv (incl. shell quoting of
  paths with apostrophes), missing-binary errors, and the CLI
  resolution table.
- Docs (usage + architecture) updated.

/imagine SKILL.md edit lives in dotfiles - deferred to coordinate
with #4.
2026-05-08 17:09:59 +02:00
2026-05-08 12:25:21 +00:00

ImaGen

Model-agnostic image-generation framework: pluggable backends (local FLUX on mRock, Replicate, DALL-E, …) behind a single CLI / skill / API.

imagen generate "a cat in a fishbowl" --backend flux-schnell-local --size 1024x1024

See CLAUDE.md for the design — backend contract, registry, config layout, how to add a new adapter.

Install

go install mgit.msbls.de/m/ImaGen/cmd/imagen@latest

Or from a checkout:

make build       # writes ./bin/imagen
make install     # installs into $GOBIN (defaults to ~/go/bin)

First run

mkdir -p ~/.config
imagen config init > ~/.config/imagen.yaml
imagen config validate
imagen backends
imagen generate "test prompt" --backend mock --output /tmp/x.png

The mock backend ships in this repo and produces a deterministic gradient PNG — useful for smoke-testing the pipeline without reaching any model.

Status

Component Status
Backend interface done (#1)
Mock backend done (#1)
ComfyUI / FLUX on mRock open (#2)
Replicate adapter open (#3)
/imagine skill open (#4)
HTTP server stubbed (#1)

Issues live at https://mgit.msbls.de/m/ImaGen/issues.

Description
Model-agnostic image-generation framework: pluggable backends (local FLUX on mRock, Replicate, DALL-E, …) behind a single CLI/API/skill.
Readme MIT 161 KiB
Languages
Go 99.3%
Shell 0.5%
Makefile 0.2%