Ticketmax

Print markdown files to an ESC/POS thermal receipt printer over TCP, USB, or serial. Supports headings, bold, underline, tables, images, QR codes, paper cuts...

Security Scan

The skill's requirements and instructions align with its stated purpose (printing markdown to ESC/POS printers); the only notable action is installing the ticketmax binary via `go install` from the project's GitHub, which is expected for this tool.

Purpose & Capability

Name, description, required binary (ticketmax), and required env var (PRINTER_ADDR) all match the stated goal of sending output to an ESC/POS printer over TCP/USB/serial.

Instruction Scope

SKILL.md instructs the agent to run the ticketmax CLI, set PRINTER_ADDR, and pipe markdown into the tool. It does not request reading unrelated files or additional environment variables, nor does it direct data to unexpected external endpoints.

Install Mechanism

Install uses `go install github.com/yatesdr/ticketmax@latest` which will fetch and compile code from the project's GitHub. This is a normal install path for a Go CLI, but it does execute remote source at build time — a standard supply-chain consideration. The host (github.com) is a well-known release host.

Credentials

Only PRINTER_ADDR is required (primaryEnv). That is proportionate to a tool that needs the printer device or network address. No unrelated secrets or config paths are requested.

Persistence & Privilege

Skill is not always-enabled and does not request elevated or cross-skill configuration. It only requires a binary and an env var; autonomous invocation is allowed but is the platform default and not combined with other red flags.

Assessment

This skill appears coherent and does what it says: it runs a CLI to print markdown to ESC/POS printers. Before installing, consider: (1) `go install` will fetch and build code from the GitHub repo — review the upstream source or pinned version if you need high assurance; (2) the binary will be able to access device paths (e.g., /dev/ttyUSB0) and network printer addresses — avoid setting PRINTER_ADDR to sensitive network endpoints; (3) printing may reveal confidential text you pipe into it, so confirm outputs before printing. If you require stronger supply-chain guarantees, install from a reviewed release or vendor-provided binary rather than `@latest`.

Print markdown files to a thermal receipt printer. Write a .md file with standard markdown and ticketmax renders it on any ESC/POS printer over TCP, USB, or serial.

Setup

Set PRINTER_ADDR to your printer's address:

# TCP:
export PRINTER_ADDR=192.168.1.100:9100
# USB:
export PRINTER_ADDR=/dev/usb/lp0
# Serial:
export PRINTER_ADDR=/dev/ttyUSB0

Usage

# Print a markdown file
ticketmax report.md

# Pipe from stdin
echo "# Hello World" | ticketmax -

# Check printer connectivity
ticketmax -status

# Print a test receipt
ticketmax -test

Flags

Flag	Default	Description
-addr	127.0.0.1:9100	Printer host:port or device path (env: PRINTER_ADDR)
-baud	9600	Baud rate for serial connections
-timeout	5s	Network connection timeout
-width	46	Paper width in characters (1–120)
-spacing	20	Line spacing in printer units (0–255)
-test		Print test receipt and exit
-status		Check connectivity and exit

Markdown Syntax

Markdown	Printer Output
# Heading	Bold, double-size, centered
## Heading	Bold, double-width, centered
### Heading	Bold
**bold text**	Bold line
<u>text</u>	Underlined line
---	Separator line
| A | B |	Two columns (right-aligned values)
| A | B | C |	Three columns
	Print image (PNG, JPEG, GIF)
```qr	QR code block
<!-- cut -->	Cut paper
<!-- beep -->	Buzzer (1 beep)
<!-- beep N -->	Buzzer (N beeps)

Example

To print a report, write markdown to a temp file and pipe it to ticketmax:

cat <<'EOF' > /tmp/report.md
# Morning Report

## Sales

| Item | Revenue |
| --- | --- |
| Widget A | $1,234 |
| Gadget B | $567 |

---

**Low stock: Widget A (3 units)**

```qr
https://dashboard.example.com

<!-- beep -->

EOF

ticketmax /tmp/report.md

Or pipe directly from stdin:

```bash
echo "# Alert\n\n**Server down at $(date)**\n\n<!-- beep 3 -->" | ticketmax -