Raptor Codex

Raptor Codex is an end-to-end Qlik IDE for VS Code-compatible editors, supporting both:

• Qlik Cloud
• Client-managed Qlik Sense Enterprise on Windows (QSEoW)

You can build apps from script to frontend analytics, sync scripts and objects, manage reloads, run embedded MCP servers, bootstrap Python SSE (qlik-py-tools) workflows, and generate AI-assisted insights from your applications.

What’s New

• Profile model (cloud + qseow) with active-profile switching
• New MCP runtime: raptor-codex-mcp (in-repo fork, MIT-attributed)
• Optional split DB MCP package: raptor-db-mcp
• Migration wizard from legacy qlikCloudScriptStudio.* settings/secrets to raptorCodex.*
• SSE toolkit commands:
  • Create SSE starter script
  • Insert SSE algorithm snippet
  • Generate SSE deployment checklist
  • Run SSE diagnostics

Quick Start

1. Open the extension sidebar.
2. Add a profile in Advanced:
   • cloud with API key, or
   • qseow with auth mode (cert_key, pfx, header)
3. Set the profile active.
4. Test/start MCP from Advanced.
5. Go to Apps tab and work as normal:
   • Refresh apps
   • Download/upload scripts
   • Reload apps

MCP Architecture

Primary MCP

• Path: mcp-server/dist/server.js
• Package: @workbalance/raptor-codex-mcp
• Purpose: Qlik Cloud + QSEoW MCP integration and script operations tooling

Optional DB MCP

• Path: mcp-db-server/dist/server.js
• Package: @workbalance/raptor-db-mcp
• Purpose: standalone database MCP tools (list_tables, describe_table, execute_query, etc.)

SSE / qlik-py-tools Workflow

Use the SSE toolkit in Advanced to generate starter files and diagnostics.

Recommended project flow:

1. Deploy qlik-py-tools container on customer infrastructure.
2. Create analytics connection in Qlik.
3. Generate sse-starter.qlik from command.
4. Validate using SSE diagnostics.
5. Iterate algorithms and commit scripts.

Migration Notes

On first activation, the extension migrates:

• Legacy settings namespace: qlikCloudScriptStudio.* -> raptorCodex.*
• Legacy secrets into profile-scoped secret keys

This is idempotent and keeps legacy values copied for safety.

Privacy & Data

• No telemetry to publisher.
• Network calls are only to configured Qlik environments and services you explicitly connect.
• Secrets are stored in VS Code secret storage.

Licensing

• Raptor Codex is proprietary Workbalance software. See /LICENSE.
• Bundled MCP components are also proprietary and are not published as open-source packages.
• Any required third-party notices or attributions are retained in:
  • /mcp-server/NOTICE
  • /mcp-db-server/NOTICE