Gikz

中文文档

Clean GeoGebra TikZ exports into concise, readable LaTeX code.

A zero-dependency Node.js CLI tool that transforms GeoGebra's verbose TikZ output into clean, hand-written-style code ready for your .tex files. Also supports direct conversion from .ggb and .xml files.

Derived from GGB-Tikz-Code-Filter by By990920. Licensed under GPL-2.0.

Features

• Strips redundant styles (line width, colors, scriptsize wrappers)
• Rounds coordinates to 3 decimal places (configurable)
• Replaces raw coordinates with named labels ((A), (B), …)
• Smart label positioning based on point geometry
• Converts line styles (dash pattern=... → dashed)
• Supports: points, lines, circles, ellipses, arcs, sectors, angle marks, function plots, Bézier curves, text labels
• Direct conversion from .ggb (GeoGebra project) and .xml files
• Output as tikzpicture fragment or complete standalone document
• Batch processing & stdin/stdout piping

Installation

# Global install (recommended)
npm install -g gikz

# Or run directly
npx gikz export.txt

# Or clone and use
git clone https://github.com/YZDame/gikz.git
cd gikz
node gikz.js export.txt

Usage

# Clean a TikZ export
gikz export.txt

# Convert a GeoGebra project file directly
gikz figure.ggb

# Convert a GeoGebra XML file
gikz geogebra.xml

# Standalone document — ready for pdflatex
gikz -s export.txt

# Write to file
gikz -s -o clean.tex figure.ggb

# Batch — multiple files to a directory
gikz fig1.ggb fig2.txt fig3.xml -o output/

# Pipe from stdin
cat export.txt | gikz -s > clean.tex

# Skip points and labels
gikz --no-points --no-labels export.txt

# Keep original coordinate precision
gikz --no-round export.txt

Supported Input Formats

Format	Description
.txt / .tex	GeoGebra TikZ export (cleans verbose code)
.ggb	GeoGebra project file (direct conversion)
.xml	GeoGebra XML file (direct conversion)

Options

Flag	Description
-s, --standalone	Output complete standalone LaTeX document
-t, --tikzonly	Output tikzpicture fragment only (default)
--no-points	Omit point markers (\draw[fill=black]...)
--no-labels	Omit point labels (\node...)
--no-round	Keep original coordinate precision
-o, --output <path>	Write to file (or directory for batch)
-h, --help	Show help

Example

Input (GeoGebra export):

\draw [line width=2pt,color=rvwvcq] (-2.75,2.1)-- (-4.89,-2.06);
\draw [fill=rvwvcq] (-2.75,2.1) circle (2.5pt);
\draw[color=rvwvcq] (-2.6468416958718426,2.3645220512615386) node {$A$};

Output (Gikz):

\coordinate (A) at (-2.75,2.1);
\draw (A) -- (B);
\draw[fill=black] (A) circle (1pt);
\node [above] at (A) {$A$};

AI Coding Agent Integration

Gikz includes skill files for AI coding agents:

Agent	File	Usage
Claude Code	CLAUDE.md	Auto-detected in workspace
OpenAI Codex	AGENTS.md	Auto-detected in workspace

These files teach the agent how to invoke Gikz to clean TikZ code within your project.

Requirements

• Node.js ≥ 14

No other dependencies.

License

GPL-2.0 — See LICENSE.

Derived from GGB-Tikz-Code-Filter by By990920.