Skip to content
GenAIScript
Blog

Blog

Continuous Markdown Translations

A visually bold, 8-bit style flowchart uses five simple colors to illustrate the journey of a Markdown document through multiple stages. It starts with the document turning into a blocky tree, then color-coded chunks are extracted. Placeholder tags are inserted before the process flows into a cloud icon (representing AI or cloud processing). Chunks reappear, now altered, and are put back into the document. The final output moves towards a stylized French flag. Icons like a disk for caching, a code block symbol, and a checkmark for quality control punctuate the diagram. There is no text or people; process steps are linked by basic geometric shapes and arrows.
Peli
Peli
GenAIScript developer

GenAIScript documentation is now accessible in French, thanks to a continuous translation workflow integrated with GitHub Actions. As documentation changes, translations are updated automatically, reducing manual effort and ensuring consistency across languages.

The translation system parses Markdown files into an Abstract Syntax Tree (AST), breaks content into translatable text chunks, and attaches unique identifiers for each segment. Only those new or modified segments are sent for translation by a large language model. This selective approach avoids unnecessary retranslation, supports idempotency, and allows granular updates without risking document drift.

Translations are then evaluated for markdown validity and URL consistency, and undergo an automated quality check using the same LLM. Validated segments are saved in a cache, so future translation runs can instantly reuse existing work and focus only on true differences. Once all checks pass, the automated workflow commits and pushes the new translations back to the repository, with no developer intervention required.

The process is robust, extensible to other languages, and leverages open-source plugins for Markdown AST manipulation. Teams benefit from localized, up-to-date documentation with minimal friction, driven entirely by automation and modern AI tooling.

v2.0 - A Node.JS library

The image shows a network of geometric blocks connected by wires, symbolizing a modular 2D server in retro 8-bit style. One block is marked with a "runtime" symbol and another with a "CLI" symbol, each featuring plug-in style ports. Flexible wire connections link a Node.js logo to these blocks. Surrounding the central setup are minimalist icons that represent code, packages, and script files. The design uses five bold corporate colors, maintains flat and iconic visuals, and has a neutral, wordless background.
Matt Podwysocki
Matt Podwysocki
GenAIScript developer
 Peli
Peli
GenAIScript developer
 GenAIScript
GenAIScript
GenAI Blogger

We’ve rolled out GenAIScript 2.0, featuring a modular and maintainable runtime now accessible in any Node.js application, beyond just the CLI. This shift involved significant backend refactoring, streamlining the integration process for developers and expanding usage possibilities. The new @genaiscript/runtime npm package isolates the core functionality, allowing direct imports and straightforward initialization in projects. For those building with the Node.js API, updating your imports ensures compatibility with the latest structure. This release makes it easier to incorporate GenAIScript into diverse workflows, whether through the CLI or embedded in broader Node.js solutions.

Writing GenAIScript Workflows Faster with Coding Assistants

A pixelated 2D illustration of a computer workstation in a corporate theme. The centerpiece is a monitor showing TypeScript code snippets, where JSDoc comments stand out clearly above corresponding functions in blocky text format. Around the monitor are minimalist, geometric icons: a gear symbolizing workflow, a tree structure signifying abstract syntax trees, and a lightning bolt representing optimization and automation. The backdrop features a tidy grid pattern, utilizing a muted palette of five professional colors. The scene is clean and devoid of human figures or written labels.
Volkan Unsal
Volkan Unsal
GenAIScript enthusiast

Documenting code can be tedious but remains critical for maintaining quality and collaboration. Using GenAIScript, you can automate the generation of JSDoc comments in TypeScript projects by leveraging AST grep for precise code analysis and LLMs for producing detailed documentation. This approach not only saves time but also enhances consistency and ensures clarity across your codebase. Practical benefits like parallel task execution, cost-efficient prompt utilization, and the shareability of workflows make GenAIScript a powerful tool for scaling such tasks in development teams.

Continuous AI

A flat, geometric 8-bit depiction of interconnected nodes forming a visual network that represents collaborative workflows. The design includes mechanical arms symbolizing automation and interlocked gears emphasizing synergy. Surrounding the network are icons for AI, software code, and deployment pipelines, arranged in a circular, seamless flow. The clean, professional design features a limited palette of blue, grey, white, yellow, and light green, conveying a modern, tech-oriented theme.
Peli
Peli
GenAIScript developer

AI is reshaping how teams build and collaborate. At GitHub, the concept of “Continuous AI” frames a future where AI-powered tools enhance workflows, much like CI/CD revolutionized automation in software development. More than a single technology, it’s an evolving category of practices and tools designed to support collaboration at scale. Initiatives like GitHub Actions, Models, and GenAIScripts highlight this direction. How could AI streamline your workflows?

Mermaids Unbroken

A minimalist 8-bit style image showing a flowchart and a class diagram side by side, with bold arrows connecting geometric shapes like squares, diamonds, and rounded rectangles in the flowchart, and rectangles connected by lines denoting relationships in the class diagram. The background subtly resembles a tech workspace with circular nodes symbolizing an abstract repair or debugging system. The design uses a corporate palette of five colors in a clean, structured layout and lacks text or characters.
Peli
Peli
GenAIScript developer

Mermaid diagrams bring clarity to complex systems, directly embedded within markdown. They empower you to illustrate workflows, relationships, and hierarchies with syntax-driven precision. However, Mermaid’s dependence on strict syntax means that errors—either manual or LLM-generated—can disrupt rendering.

When errors occur, integrating automated repair systems in workflows, like the “repairer” in the system.diagrams system prompt, ensures diagrams remain functional. This process not only resolves syntax issues but also refines communication between human inputs and AI-generated outputs, maintaining diagram integrity.

Whether you’re summarizing application structure or detailing intricate interfaces, the harmony of Markdown and automated corrections streamlines your ability to visualize data effectively.