gnd

Gendo Documentation

Gendo is a locally executed, AI-assisted programming system designed for offline code generation and execution. It provides a minimal, deterministic format that enables AI to generate, analyze, and repair code while remaining human-readable and maintainable.

Core Components

The Gendo toolchain consists of three main executables:

• gnd: The runtime interpreter for executing .gnd scripts (Roadmap)
• gndc: The compiler front-end that processes natural language headers and generates implementation files (Roadmap)
• gndtest: The test runner for evaluating test cases (Roadmap)

Language Documentation

Core Syntax

• Gendo Syntax Specification - Complete language syntax and file format specification

Built-in Operations

Flow Control

• let - Variable assignment and binding
• return - Early return from execution
• exit - Program termination
• exec - Execute instructions
• compile - Compile instructions
• code - Code block handling
• async - Asynchronous execution
• await - Wait for async operations
• wait - Wait for conditions
• throw - Error handling
• status - Status checking

String Operations

• concat - String concatenation
• trim - String trimming
• uppercase - Convert to uppercase
• lowercase - Convert to lowercase
• eq - Equality comparison

Output and Logging

• print - Standard output
• log - Logging
• debug - Debug output
• info - Information messages
• warn - Warning messages
• error - Error messages

AI Integration

• prompt - AI prompt handling

Type Operations

• string - String type operations
• bool - Boolean type operations
• int - Integer type operations
• int8 - 8-bit integer operations
• int16 - 16-bit integer operations
• int32 - 32-bit integer operations
• int64 - 64-bit integer operations
• uint - Unsigned integer operations
• uint8 - 8-bit unsigned integer operations
• uint16 - 16-bit unsigned integer operations
• uint32 - 32-bit unsigned integer operations
• uint64 - 64-bit unsigned integer operations
• float32 - 32-bit floating point operations
• float64 - 64-bit floating point operations

Getting Started

To begin using Gendo:

1. Write your intent in a .llm file
2. Optionally provide implementation guidance in a .gnd.llm file
3. Use gndc to generate the implementation
4. Execute the resulting .gnd file with gnd

For testing, write your test cases in .test.gnd.llm or .test.llm files and use gndtest to run them.

Key Features

• Offline Operation: All phases run locally with no hidden state
• Deterministic: Consistent behavior across executions
• AI-Friendly: Designed for automated code generation and analysis
• Human-Readable: Simple syntax for manual inspection and modification
• Extensible: Modular design supporting future additions

File Organization

A Gendo unit consists of multiple files sharing the same base name:

• .llm - Natural language header
• .gnd.llm - Optional implementation prompt
• .gnd - Generated implementation
• .gnc - Compact compiled form (optional)

Numbered fragments (e.g., 010-foo.gnd, 020-foo.gnd) are automatically concatenated in order.