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.
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
Stagnant productivity
Fear of change
KB Sync solves all of this. It externalizes your Knowledge Base to plain text files — versionable, editable, and AI-ready — 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.
Connect your KB
Configure the path to your GeneXus Knowledge Base and the directory where you want the files.
Automatic export
KB Sync detects new or modified objects and converts them to plain text files in real time.
Edit freely
Use KB Editor with IntelliSense and AI, or any tool of your choice. The files are pure text.
Sync back
When you save, changes are validated and automatically imported into the Knowledge Base. No manual intervention.
Everything you need, in one package
KB Sync consists 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, 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
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)
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 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 |
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.
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 Type | Extension | Read | Write |
|---|---|---|---|
| Procedure | .Procedure.gxSource | Yes | Yes |
| Transaction | .Transaction.gxSource | Yes | Yes |
| Web Panel | .WebPanel.gxSource | Yes | Yes |
| SD Panel | .SDPanel.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 | .Group.gxSource | Yes | Yes |
| Unit Test | .UnitTest.gxSource | Yes | Yes |
| Domain | .gxDomain | Yes | Yes |
| Attribute | .gxAttribute | Yes | Yes |
| Table | .Table.gxSource | Read-only | — |
| Pattern Instance | .gxPattern | Yes | Yes |
Tables are exported as a read-only reference so AI tools can consult them. They are modified indirectly by modifying Transactions.
Smart filters
You don't need to sync the 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 Ventas module except temporary procedures, but always including Ventas.TempImport:
Module = Ventas
Procedure = Ventas.Temp*
Procedure = Ventas.TempImport
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
@ = Module
# = System
. = Hidden children
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.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
- 4.If another developer modifies something in GeneXus, KB Sync exports it automatically
- 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.
Configuration your way
Each Knowledge Base is configured independently. Multiple KBs, different GeneXus versions, different sync rules.
Multi-version GeneXus
Configurable cycles
Auto-start
Admin mode
Long paths
Live console
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.