KB Sync
The intelligent bridge between your GeneXus Knowledge Base and modern development.
Automatic bidirectional synchronization, specify and compile on request, AI support, and full control from a visual interface.
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.
Trapped code
No real Git
Blind AI
Isolated teams
Compiling means going back to the IDE
Fear of change
KB Sync solves all of this. It externalizes your Knowledge Base to plain text files — versionable, editable, and AI-ready — and specifies, generates and compiles on request, all without leaving GeneXus behind.
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, with specification and compilation on request.
Connect your KB
Point KB Sync at your GeneXus Knowledge Base and at the directory where you want the files.
Automatic export
KB Sync detects new, modified, renamed or moved objects and turns them into plain text files in real time.
Edit freely
Use KB Editor with IntelliSense, visual editors and AI, or any tool you prefer. The files are pure text.
Sync and build back
On save, changes are validated and imported into the Knowledge Base in dependency order — and you can request specification, generation or compilation without opening the IDE.
Everything you need, in one package
KB Sync is made of two applications that work together: a visual control panel and a synchronization engine.
KB Sync Manager
The visual application where you control everything. Configure your Knowledge Bases, manage synchronization, decide how and when to build, and monitor activity — all from the Windows system tray.
- ✦Multiple KBs with real-time status indicators
- ✦Live console with two channels: General (synchronization) and Build
- ✦Search inside the console and the log viewer (Ctrl+F) with a match counter
- ✦Filters by module, folder or object type
- ✦Per-KB build settings: automatic build after sync, scope and environment
- ✦Detection of the KB's environments so you can pick which one to build against
- ✦Automatic deployment of documentation for AI tools
- ✦Automatic start with Windows and per KB
- ✦Windows Server support with independent sessions
KB Sync Engine
The engine that does the heavy lifting. Continuous bidirectional sync cycles that keep your files and your KB perfectly aligned, plus a build queue that runs alongside them.
- ✦Incremental export: only processes what changed since the last cycle
- ✦Import in dependency order, with automatic retries within the same cycle
- ✦Support for 20+ GeneXus object types, including Forms, report layouts and File objects
- ✦Specification, generation and compilation on request, with a navigation report per object
- ✦Configurable cycles (default: every 10 seconds)
- ✦Compatible with GeneXus X, X Evo1, X Evo2, X Evo3, 15, 16, 17 and 18
Specify, generate and compile without opening the IDE
KB Sync doesn't just move files: it runs the full GeneXus cycle on request. From KB Editor you ask to specify, generate or compile, and the engine returns each object's errors and navigation report.
Four scopes
Never interrupts the sync
Errors on the exact object
Navigation report
Automatic build after sync
Environments
Pattern instances
Build All
The engine never triggers a database reorganization as part of a build. Available on GeneXus X Evo1, X Evo2, X Evo3, 15, 16, 17 and 18.
Ready for any AI tool
KB Sync Manager automatically deploys context documentation so AI tools understand your GeneXus project from the very first prompt.
| AI Tool | Deployed file |
|---|---|
| Claude Code | ai/CLAUDE.md |
| Codex | ai/CODEX.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Cursor | .cursorrules |
| Windsurf | .windsurfrules |
| Cline | .clinerules |
| Roo Code | .roorules |
It also deploys ai/start-here.md as a general entry point and a full ai/kbbridge/ folder with reference documentation for the GeneXus language, file formats, diagnostic guides for import errors, and a per-object-type property catalog (allowed values, defaults and applicable version).
20+ supported object types
KB Sync works with virtually every GeneXus object type. Each object becomes one or more readable, editable plain text files — and only the properties that differ from their default are written out.
| Object Type | Extension | Read | Write |
|---|---|---|---|
| Procedure | .Procedure.gxSource + .gxLayout | Yes | Yes |
| Transaction | .Transaction.gxSource + .gxForm | Yes | Yes |
| Web Panel | .WebPanel.gxSource + .gxForm | Yes | Yes |
| Web Component | .WebComponent.gxSource + .gxForm | Yes | Yes |
| Web Master Page | .WebMasterPage.gxSource + .gxForm | Yes | Yes |
| Panel (Smart Device) | .Panel.gxSource + .gxForm | Yes | Yes |
| Work Panel | .WorkPanel.gxSource | Yes | Yes |
| Data Provider | .DataProvider.gxSource | Yes | Yes |
| Data Selector | .DataSelector.gxSource | Yes | Yes |
| SDT | .StructuredDataType.gxSource | Yes | Yes |
| External Object | .ExternalObject.gxSource | Yes | Yes |
| API | .API.gxSource | Yes | Yes |
| Group / Subtype Group | .Group.gxSource | Yes | Yes |
| Unit Test | .UnitTest.gxSource | Yes | Yes |
| File (attachments) | .File.gxSource + .File.gxFile | Yes | Yes |
| Domain | .gxDomain | Yes | Yes |
| Attribute | .gxAttribute | Yes | Yes |
| Table | .Table.gxSource | Yes | User-defined indexes only |
| Pattern Instance | .gxPattern | Yes | Yes |
| User Controls | User Controls/ | Yes | — |
| Pattern definitions | Patterns/ | Yes | — |
Tables are exported as a reference AI tools can consult; their user-defined indexes are editable from the plain text file. User Controls and pattern definitions are exported as design material, so the editor can render them and AI can understand them.
Smart filters
You don't need to sync your entire KB. KB Sync lets you define exactly which objects to export and import.
Scope (Objects)
Exclusions (Exclude)
Forced inclusion (Include)
Practical example
Sync the entire Sales module except temporary procedures, but always including Sales.TempImport:
Module = Sales
Procedure = Sales.Temp*
Procedure = Sales.TempImport
Your project, organized
KB Sync generates a clear, predictable directory structure that mirrors your Knowledge Base's organization — and keeps it that way: move or rename a folder or module in GeneXus and the externalized directory moves with it.
ProjectRoot/ ├── .kbbridge-sync/ ← Synchronization metadata ├── ai/ ← Documentation for AI tools │ ├── kbbridge/ ← GeneXus language reference │ │ └── genexus-properties/ ← Property catalog per object type │ ├── CLAUDE.md │ └── start-here.md ├── Knowledge Base/ ← All GeneXus objects │ ├── @ModuleName/ ← Modules (namespace) │ │ ├── @SubModule/ ← Nested modules │ │ ├── #Domains/ ← Module domains │ │ ├── MyProc.Procedure.gxSource │ │ ├── MyProc.Procedure.gxLayout │ │ ├── Customer.Transaction.gxSource │ │ └── Customer.Transaction.gxForm │ ├── #Attributes/ ← Global attributes │ ├── #Domains/ ← Global domains │ ├── #Files/ ← File objects and their attachments │ └── #Tables/ ← Tables (editable indexes) ├── Patterns/ ← Pattern definitions └── User Controls/ ← User Controls (design files)
@ = Module
# = System
. = Hidden children
Team development, solved
KB Sync was designed for teams. Each developer works with their own change files, and the engine coordinates everything.
Multi-user flow
- 1.A developer edits a file with KB Editor or an AI tool
- 2.The change is automatically recorded in their personal tracking file
- 3.KB Sync detects the change and imports it into the Knowledge Base — a moved or renamed object travels as a single change, not a delete plus a create
- 4.If another developer changes something in GeneXus, KB Sync exports it automatically
- 5.Every developer sees the changes reflected in their files, and each one sees the build result of their own changes
Automatic validation
Every change 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
- ✦GeneXus internal validation
- ✦Application in dependency order, with a retry pass at the end of every cycle
- ✦Detailed report with section, line and column on error
Errors don't stop the synchronization. The change is flagged as an error, the modified file is protected from being overwritten, and the developer can fix it and save again — or discard the local changes from KB Editor and re-export the object from the KB.
Configuration your way
Each Knowledge Base is configured independently. Multiple KBs, different GeneXus versions, different sync and build rules.
Multi-version GeneXus
Configurable cycles
Automatic build
Build environment
Auto-start
Administrator mode
Long paths
Live console
AI documentation
Install 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)
- ✦Engine binaries for every supported GeneXus version, from X to 18
- ✦Documentation for AI tools, ready to deploy into the project
- ✦Start-with-Windows options and desktop shortcut
- ✦Multi-language support: English, Spanish, Portuguese
- ✦Automatic new-version notice and detection of running instances during upgrade
Requirements
- ✦Windows 10/11 or Windows Server
- ✦GeneXus X, X Evo1/2/3, 15, 16, 17 or 18 installed
- ✦Access to the Knowledge Base
- ✦15-day free trial — no credit card
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 — and compile without leaving your editor.
For developers
Edit with KB Editor, use AI, build from the editor and version with Git. All without leaving GeneXus.
For teams
Real collaboration with text files, per-user change tracking, automatic validation and builds attributed to each developer.
For organizations
Simple installation, Windows Server support, and compatibility with every GeneXus version from X to 18.
For the ecosystem
A bridge between the power of GeneXus and the modern tools today's developers expect.