Overview
Protrak Forge helps you build Protrak customizations faster and more reliably. It gives your AI coding agent real Protrak expertise and manages your customization schema — all from inside your editor.
What Forge does
Forge does two jobs:
- Gives your AI coding agent Protrak expertise. With Forge installed, GitHub Copilot, Claude Code, or Codex can read your project's schema and generate correct C# programs, Design Studio layouts, rules, queries, widgets, and notification templates — without hallucinating API contracts or attribute-access patterns. You describe what you want in plain English; the agent does the schema lookup, generation, and validation. It can also audit the whole workspace for structural problems — missing lifecycles, duplicate names, unused attributes, circular promote paths.
- Manages your schema. Import a schema from a running Protrak server (or a file) into your project, and export your local changes back — right from VS Code.
Where it fits in an implementation project
A Protrak customization project is a large graph of schema elements — Types, Attributes, Lifecycles, Relation Types, Rules, Programs, and Design Studio layouts — held together by exact string references. Authoring it by hand is slow and easy to get subtly wrong (a mistyped attribute name, a wrong interface, a program that doesn't compile).
Forge sits between you and that complexity. You work at the level of intent ("add a Capacity attribute to Equipment and show it on the Create form"); Forge gives your agent the exact schema, the right interface contract, and proven patterns, then writes and validates the files. You review the result before it goes anywhere.
How it's delivered
Forge ships as two aligned artifacts you can use together or separately:
| Artifact | Use it for |
|---|---|
VS Code extension (prorigo.protrak-forge) | Auto-configures GitHub Copilot, plus schema import/export, project scaffolding, and connection management as VS Code commands |
npm package (@prorigo/protrak-forge) | A standalone MCP server for Claude Code, Codex, or any MCP-capable agent |
The AI-assistance features work with GitHub Copilot, Claude Code, and Codex. See Getting Started to install and connect your agent.
Local and private
Everything runs locally on your machine. The only network calls Forge makes are the schema Import/Export you explicitly run against a server you've configured — no API keys, no telemetry, no Docker. Your schema and code never leave your machine except when you choose to import or export.
Next steps
- Getting Started — install Forge and connect your AI agent.
- Authoring with AI — describe what you want and let the agent build it.
- Schema Import & Export — sync your project with a Protrak server.