convez.ai
MCP ServerAutomaçãoAvançado
vexyart

Vexy Lines CLI

vexyart/vexy-lines-cli

CLI e MCP server para automação de arte vetorial e processamento de estilo

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP e interface de linha de comando para Vexy Lines, a app de arte vetorial macOS/Windows. Permite parsear arquivos .lines, exportar em lote para PDF/SVG, aplicar estilos a imagens e vídeos, e integrar Claude Desktop ou Cursor diretamente à API do Vexy Lines.

Instalação

$npx convez-ai vexyart/vexy-lines-cli

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 dias
Versão
v1.0.38
Issues abertas
0
Contribuidores
1

Casos de uso

  • Exportar em lote arquivos .lines para PDF ou SVG sem interface gráfica
  • Aplicar templates de estilo a imagens e vídeos automaticamente
  • Integrar Vexy Lines em workflows Claude Desktop ou Cursor via MCP

Veredito

Ferramenta especializada para artistas e designers que precisam automatizar fluxos de trabalho com Vexy Lines. A integração MCP torna possível delegar tarefas de processamento de arte vetorial ao Claude, mas demanda familiaridade com CLI e Python 3.11+.

README

A tradução para o português deste README ainda está na fila.

vexy-lines-cli

Command-line interface and MCP passthrough server for Vexy Lines — the macOS vector art app.

Parse .lines files, batch export to PDF/SVG, apply styles to images and video, and connect Claude Desktop or Cursor directly to the Vexy Lines MCP API.

Install

pip install vexy-lines-cli

Requires Python 3.11+. Pulls in vexy-lines-apy (MCP client, style engine) and vexy-lines-py (parser) automatically.

For video processing and the GUI: pip install vexy-lines-run (all dependencies are included).

Quick start

# Inspect a file without opening the app
vexy-lines-cli info artwork.lines

# Show the layer/group/fill tree
vexy-lines-cli file-tree artwork.lines

# Export a folder of .lines files to PDF (auto-launches the app)
vexy-lines-cli export ./my-art/ --format pdf

# Apply a style template to a folder of photos
vexy-lines-cli style-transfer --style template.lines --input-dir ./photos/ --output-dir ./out/

# Check MCP connectivity
vexy-lines-cli mcp-status

Subcommand reference

Parser — no app required

CommandWhat it does
info <file>Show caption, DPI, dimensions, layer/fill/filter counts
file-tree <file>Print the layer/group/fill hierarchy, including image filters
extract-source <file>Save the embedded source image to disk
extract-preview <file>Save the embedded preview image to disk
batch-convertExtract preview or source images from a directory of .lines files

All parser commands accept --json-output for machine-readable output.

vexy-lines-cli info artwork.lines --json-output
vexy-lines-cli batch-convert --input-dir ./art/ --output-dir ./thumbs/ --what preview --format jpg

Export — auto-launches app

Uses dialog-less export: injects settings into macOS preferences, triggers File > Export, then restores original prefs. Input can be a single file or a directory.

vexy-lines-cli export ./art/ --format svg --output ./svg-out/
vexy-lines-cli export artwork.lines --format pdf --dry-run   # preview without exporting
vexy-lines-cli export ./art/ --force --timeout-multiplier 2

Options: --format (pdf/svg), --force, --dry-run, --timeout-multiplier (0.1–10.0), --max-retries (0–10), --say-summary.

Style — app must be running

# Single style across all images
vexy-lines-cli style-transfer --style look.lines --input-dir ./frames/ --format svg

# Interpolate between two styles across the sequence
vexy-lines-cli style-transfer --style start.lines --end-style end.lines \
    --input-dir ./frames/ --output-dir ./out/

# Apply style to video
vexy-lines-cli style-video --style look.lines --input clip.mp4 --output result.mp4

# Resume an interrupted video job (automatic — just re-run the same command)
vexy-lines-cli style-video --style look.lines --input clip.mp4 --output result.mp4

# Force restart (discard cached frames)
vexy-lines-cli style-video --style look.lines --input clip.mp4 --output result.mp4 --force

# Auto-clean job folder after completion
vexy-lines-cli style-transfer --style look.lines --input-dir ./frames/ --cleanup

All style commands create a job folder ({output}-vljob/) that stores intermediate .lines, .svg, and raster files. If the process is interrupted, re-running the same command skips already-completed items. Use --force to start fresh or --cleanup to remove the job folder after completion.

MCP — app must be running

Direct JSON-RPC calls to the Vexy Lines embedded server (localhost:47384).

CommandWhat it does
mcp-statusCheck if the MCP server is reachable
treePrint the live document layer tree
new-documentCreate a new document
open <file>Open a .lines file
add-fill <layer-id> <fill-type>Add a fill to a layer
get-image-filters <fill-id>Read a fill's image-filter chain
set-image-filters <fill-id> <filters-json>Replace a fill's image-filter chain
add-image-filter <fill-id> <filter-type>Add one image filter to a fill
remove-image-filter <fill-id> <index>Remove one image filter from a fill
renderTrigger a full render
vexy-lines-cli mcp-status
vexy-lines-cli tree --json-output
vexy-lines-cli new-document --width 210 --height 297 --dpi 300
vexy-lines-cli add-fill 42 linear --color "#ff0000"
vexy-lines-cli get-image-filters 99
vexy-lines-cli set-image-filters 99 '[{"type":"brightness","params":{"value":25}}]'
vexy-lines-cli add-image-filter 99 levels --params '{"left":10,"right":240}'

All MCP commands accept --host and --port (defaults: 127.0.0.1:47384).

MCP bridge

CommandWhat it does
mcp-serveStart the stdio-to-TCP bridge (same as running vexy-lines-mcp)

AI rename — auto-launches app + needs a vision model

Rename a .lines file's layers and fills with a vision-language model. Each fill is rendered in isolation, boxed over a faint copy of the full artwork, and given a short descriptive caption; layers are named from their fills. Only captions change — every fill parameter and embedded image is preserved.

pip install "vexy-lines-cli[ai]"          # openai + pathvalidate + python-slugify

vexy-lines-cli ai-rename road-12.lines              # -> road-12-renamed.lines
vexy-lines-cli ai-rename road-12.lines --dry-run    # preview names, write nothing
vexy-lines-cli ai-rename road-12.lines --json-output
vexy-lines-cli ai-rename road-12.lines \
    --llm-api-url http://127.0.0.1:1234/v1 --llm-model-vision my-vision-model

The endpoint is an OpenAI-compatible /v1 server, configured from the environment — VEXY_LINES_LLM_API_URL, VEXY_LINES_LLM_API_KEY, VEXY_LINES_LLM_MODEL_VISION (vision), VEXY_LINES_VLM_MODEL (text) — and overridable with --llm-api-url, --llm-api-key, --llm-model-vision, --llm-model. See the full AI rename guide.

MCP server setup

vexy-lines-mcp bridges Claude Desktop and Cursor to the Vexy Lines TCP server. It reads newline-delimited JSON-RPC from stdin, forwards over TCP, and writes responses to stdout.

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vexy-lines": {
      "command": "vexy-lines-mcp"
    }
  }
}

For Cursor, add the same block under mcp.servers in .cursor/mcp.json.

The bridge auto-launches the Vexy Lines app on first connection. Pass --no-launch to disable:

vexy-lines-cli mcp-serve --no-launch
vexy-lines-cli mcp-serve --host 127.0.0.1 --port 47384

Full documentation

Read the docs for the complete CLI reference, export pipeline internals, and more examples.

License

MIT

Ver o original no GitHub

Bom para

Relacionados