Plot data with gnuplot
Plot data from the most recent interaction context using gnuplot. Generate a PNG image with a transparent background and output it as a markdown image so it renders inline.
How to plot
- Extract or derive plottable data from the current context.
- If the Emacs foreground color is not already known from a previous plot in this session, query it:
This returns a hex color likeemacsclient --eval ' (face-foreground (quote default))'"#eeffff". Reuse it for all subsequent plots. - Write a gnuplot script to a temporary file using that color.
- Run gnuplot on the script.
- Output the result as a markdown image on its own line:

gnuplot /tmp/agent-plot-XXXX.gp
Gnuplot script template
set terminal pngcairo transparent enhanced size 800,500
set output "/tmp/agent-plot-XXXX.png"
FG = "#eeffff" # from emacsclient query
set border lc rgb FG
set key textcolor rgb FG
set xlabel textcolor rgb FG
set ylabel textcolor rgb FG
set title textcolor rgb FG
set xtics textcolor rgb FG
set ytics textcolor rgb FG
# ... plot commands using the data ...
Rules
- Query the Emacs foreground color once per session and reuse it for all subsequent plots. Only query again if the color is not already known.
- Always use
pngcairo transparentterminal for transparent background. - Always use a timestamp in the filename (e.g.,
/tmp/agent-plot-$(date +%s).png). Never use descriptive names likeagent-plot-lorenz.png. - Use inline data (
$DATA << EOD ... EOD) when practical. For large datasets, write a separate data file. - After gnuplot runs successfully, output a markdown image (
) on its own line. - Choose an appropriate plot type for the data (lines, bars, histogram, scatter, etc.).
- Include a title, axis labels, and a legend when they add clarity.
- Use
enhancedtext mode for subscripts/superscripts when needed. - If no plottable data exists in the recent context, inform the user.