Core Engine

KB Sync

The intelligent bridge between your GeneXus Knowledge Base and modern development.

Automatic bidirectional synchronization, AI support, and full control from a visual interface.

The challenge

Why do you need KB Sync?

GeneXus teams face a frustrating reality: their code lives locked inside a proprietary Knowledge Base, inaccessible to the modern tools that are transforming software development.

KBbridge

Trapped code

Your business logic lives inside the GeneXus KB. You can't version it with Git, review it as a team, or use AI tools to improve it.
KBbridge

No real Git

GeneXus doesn't work with text files. No files means no Git. No Git means no pull requests, no code review, no reliable change history.
KBbridge

Blind AI

Claude, Copilot, Cursor — all AI tools need text files to work. The binary GeneXus KB leaves them completely out.
KBbridge

Isolated teams

Each developer works on their own island. There's no simple way to see what changed, who changed it, or when.
KBbridge

Stagnant productivity

While the rest of the world accelerates with AI, GeneXus teams keep working exactly the same way they did 10 years ago.
KBbridge

Fear of change

You want to modernize but can't abandon your GeneXus investment. You need a bridge, not a break.

KB Sync solves all of this. It externalizes your Knowledge Base to plain text files — versionable, editable, and AI-ready — without leaving GeneXus behind.

How it works

Intelligent synchronization

KB Sync transforms your Knowledge Base objects into plain text files and keeps them synchronized in both directions. Edit with KB Editor, AI, or any tool — and changes flow back to GeneXus automatically.

I

Connect your KB

Configure the path to your GeneXus Knowledge Base and the directory where you want the files.

II

Automatic export

KB Sync detects new or modified objects and converts them to plain text files in real time.

III

Edit freely

Use KB Editor with IntelliSense and AI, or any tool of your choice. The files are pure text.

IV

Sync back

When you save, changes are validated and automatically imported into the Knowledge Base. No manual intervention.

Components

Everything you need, in one package

KB Sync consists of two applications that work together: a visual control panel and a synchronization engine.

Control Panel

KB Sync Manager

The visual application where you control everything. Configure your Knowledge Bases, manage synchronization, and monitor activity — all from the Windows system tray.

  • Multiple KBs with real-time status indicators
  • Live console with synchronization output
  • Filters by module, folder, or object type
  • Automatic deployment of documentation for AI tools
  • Auto-start with Windows and per KB
  • Support for Windows Server with independent sessions
Synchronization Engine

KB Sync Engine

The engine that does the heavy lifting. Continuous bidirectional synchronization cycles that keep your files and your KB perfectly aligned.

  • Smart export: only processes what changed since the last cycle
  • Import with full validation before writing to the KB
  • Support for 15+ GeneXus object types
  • Configurable cycles (default: every 10 seconds)
  • Compatible with GeneXus 17 and 18 (more versions coming soon)
AI Ready

Ready for any AI tool

KB Sync Manager automatically deploys context documentation so AI tools understand your GeneXus project from the very first moment.

AI ToolDeployed file
Claude Codeai/CLAUDE.md
Codexai/CODEX.md
GitHub Copilot.github/copilot-instructions.md
Cursor.cursorrules
Windsurf.windsurfrules
Cline.clinerules
Roo Code.roorules

Additionally, ai/start-here.md is deployed as a general entry point and a complete ai/kbbridge/ folder with GeneXus language reference documentation, file formats, and code examples.

Compatibility

15+ supported object types

KB Sync works with virtually all GeneXus object types. Each object is converted into a readable and editable plain text file.

Object TypeExtensionReadWrite
Procedure.Procedure.gxSourceYesYes
Transaction.Transaction.gxSourceYesYes
Web Panel.WebPanel.gxSourceYesYes
SD Panel.SDPanel.gxSourceYesYes
Data Provider.DataProvider.gxSourceYesYes
Data Selector.DataSelector.gxSourceYesYes
SDT.StructuredDataType.gxSourceYesYes
External Object.ExternalObject.gxSourceYesYes
API.API.gxSourceYesYes
Group.Group.gxSourceYesYes
Unit Test.UnitTest.gxSourceYesYes
Domain.gxDomainYesYes
Attribute.gxAttributeYesYes
Table.Table.gxSourceRead-only
Pattern Instance.gxPatternYesYes

Tables are exported as a read-only reference so AI tools can consult them. They are modified indirectly by modifying Transactions.

Full control

Smart filters

You don't need to sync the entire KB. KB Sync lets you define exactly which objects to export and import.

KBbridge

Scope (Objects)

Define which modules, folders, or object types you want to sync. If empty, everything is synced.
KBbridge

Exclusions (Exclude)

Exclude specific objects within the scope — ideal for temporary or test objects.
KBbridge

Forced inclusion (Include)

Force the inclusion of objects that would otherwise be excluded. Has the highest priority.

Practical example

Sync the entire Ventas module except temporary procedures, but always including Ventas.TempImport:

Objects

Module = Ventas

Exclude

Procedure = Ventas.Temp*

Include

Procedure = Ventas.TempImport

Organization

Your project, organized

KB Sync generates a clear and predictable directory structure that mirrors your Knowledge Base organization.

ProjectRoot/
├── .kbbridge-sync/              ← Synchronization metadata
├── ai/                          ← Documentation for AI tools
│   ├── kbbridge/                ← GeneXus language reference
│   ├── CLAUDE.md
│   └── start-here.md
├── Knowledge Base/              ← All GeneXus objects
│   ├── @ModuleName/             ← Modules (namespace)
│   │   ├── @SubModule/          ← Nested modules
│   │   ├── #Domains/            ← Module domains
│   │   ├── MyProc.Procedure.gxSource
│   │   └── Customer.Transaction.gxSource
│   ├── #Attributes/             ← Global attributes
│   ├── #Domains/                ← Global domains
│   └── #Tables/                 ← Tables (read-only)
└── Patterns/                    ← Pattern definitions
KBbridge

@ = Module

Directories with @ represent GeneXus modules (namespaces). They support unlimited nesting.
KBbridge

# = System

Folders with # are system folders: Attributes, Domains, Tables. They should not be modified manually.
KBbridge

. = Hidden children

Folders with . contain transaction child objects, organized automatically.
Collaboration

Teamwork, solved

KB Sync was designed for teams. Each developer works with their own change files, and the engine handles coordination.

Multi-user workflow

  1. 1.A developer edits a file with KB Editor or an AI tool
  2. 2.The change is automatically recorded in their personal tracking file
  3. 3.KB Sync detects the change and imports it into the Knowledge Base
  4. 4.If another developer modifies something in GeneXus, KB Sync exports it automatically
  5. 5.All developers see the changes reflected in their files

Automatic validation

Every change that KB Sync imports goes through a complete validation process before writing to the Knowledge Base:

  • Parsing and verification of the file structure
  • Validation of referenced data types
  • Internal GeneXus validation
  • Detailed report with section, line, and column on error

Errors don't stop synchronization. The change is marked as an error and the developer can fix it and save again.

Flexible

Configuration your way

Each Knowledge Base is configured independently. Multiple KBs, different GeneXus versions, different sync rules.

KBbridge

Multi-version GeneXus

Supports GeneXus X, X Evo1/2/3, 15, 16, 17 and 18. Auto-detects the installation from the Windows registry.
KBbridge

Configurable cycles

Adjust the sync interval (default: 10 sec), the lookback window, and retention limits.
KBbridge

Auto-start

Configure KBs to start automatically when opening the Manager, and even when booting Windows.
KBbridge

Admin mode

For KBs in protected paths (Program Files). Runs synchronization with elevated privileges via UAC.
KBbridge

Long paths

Support for paths longer than 260 characters — needed when the module structure generates long paths.
KBbridge

Live console

Monitor synchronization in real time with auto-scroll, noise filtering, and copy/clear options.
Simple

Installation in minutes

One installer, everything included. No external dependencies, no manual runtime configuration.

Included in the installer

  • KB Sync Manager (self-contained executable, no .NET required)
  • KB Sync binaries for each supported GeneXus version
  • Windows startup and shortcut options
  • Multi-language support: English, Spanish, Portuguese
  • Running instance detection during updates

Requirements

  • Windows 10/11 or Windows Server
  • GeneXus 17 or 18 installed
  • Access to the Knowledge Base
  • 15-day free trial — no credit card required

Free your GeneXus code

Stop being limited by the GeneXus IDE. With KB Sync, your Knowledge Base becomes text files you can version, share, and supercharge with artificial intelligence.

For developers

Edit with KB Editor, use AI, and version with Git. All without leaving GeneXus.

For teams

Real collaboration with text files, per-user change tracking, and automatic validation.

For organizations

Simple installation, Windows Server support, and compatibility with multiple GeneXus versions.

For the ecosystem

A bridge between the power of GeneXus and the modern tools developers expect today.