Getting Started
From zero to architecture-aware AI in 5 minutes.
Prerequisites
Forge DevKit works as a plugin system for AI coding assistants. You need one of these installed:
Claude Code
Official CLI by Anthropic
Recommended
Cursor
AI-powered code editor
Claude Desktop
Desktop app with MCP
Node.js 18+ is required for the Forge CLI.
Verify with node --version
Install Forge CLI
$ npm install -g @reumbra/forge
This installs the forge command globally.
Activate your license
$ forge activate FRG-XXXX-XXXX-XXXX
Use the license key from your purchase confirmation email. Each license supports up to 3 devices.
Don't have a license? Get one here.
Install plugins
After activation, forge automatically installs all plugins included in your plan. Run it to see your ecosystem:
forge
✦ Forge — Plugin manager for Claude Code v0.3.8
● Licensed FRG-YGGT..TRE4 · bundle · expires Mar 6, 2027 (365d)
6 plugins installed
◆ What would you like to do?
● Manage plugins (6 installed)
○ License & devices
○ Run diagnostics
○ Deactivate
○ Exit
| Plugin | Version | Status | Description |
|---|---|---|---|
| forge-autopilot | v1.4.0 | ✓ up to date | Batch autonomous development — parallel feature pipeline with Agent Teams |
| forge-core | v4.13.0 | ✓ up to date | Core PM pipeline — setup, dev skills, parallel conductor |
| forge-product | v3.9.0 | ✓ up to date | Product design module — user flows, stories, UX criteria |
| forge-qa | v3.7.0 | ✓ up to date | QA meta-tool — test generation, coverage analysis, requirement traceability |
| forge-tracker | v3.3.0 | ✓ up to date | Issue tracking integration — GitHub/Linear/Jira sync |
| forge-worktree | v1.2.0 | ✓ up to date | Git worktree lifecycle — Docker isolation, port offsets, safe teardown |
Restart your AI session
Important
After installing or updating plugins, you must restart your AI session for changes to take effect.
Claude Code CLI
Type /exit then run claude again
Cursor
Reload window: Cmd+Shift+P → Developer: Reload Window
Claude Desktop
Close and reopen the app, or start a new conversation
Verify installation
In your AI session, run /plugins → navigate to marketplace → reumbra. You should see all your installed Forge plugins with their versions.
Alternatively, type /forge:setup to launch the setup wizard.
Run the setup wizard
Navigate to your project directory and run:
$ /forge:setup
The wizard runs through gates sequentially — detecting your ecosystem, auditing architecture, configuring pipeline, and generating project-specific dev-skills.
◆ Forge Ecosystem
Your project management meta-tools. Each adapter generates artifacts
in your project's .claude/ directory and can be safely removed afterward.
| Module | Version | What it does |
|---|---|---|
| forge-core | v4.13.0 | Dev-pipeline: architecture + contracts + code |
| forge-product | v3.9.0 | Product design: user flows, stories, UX |
| forge-qa | v3.7.0 | Test strategy: coverage, acceptance tests |
| forge-tracker | v3.3.0 | Task hub: GitHub/Linear/ClickUp sync |
| forge-autopilot | v1.4.0 | Batch autonomous dev: triage, waves, parallel |
| forge-worktree | v1.2.0 | Git worktree management for isolated dev |
Legend: All 6 modules installed, none yet configured.
Commands available after setup:
| Category | Commands |
|---|---|
| Setup & Management | /forge:setup, /forge:upgrade, /forge:patch |
| Development | /dev, /forge:sync, /forge:close |
| Product | /forge:product-setup, /forge:product epic/roadmap |
| Testing | /qa, /qa-setup |
| Task Tracking | /forge:tracker pick/sync/close |
| Autopilot | /autopilot |
| Worktrees | /worktree-setup |
◆ Gate 1: Architecture Audit — Results
Stack: Astro 5.7.0 + TypeScript 5.8.0 + Tailwind CSS 4.1.0
Build: Vite │ Linter: Biome 2.0.0 │ Hosting: Cloudflare Pages
Architecture: FSD-adapted (4 layers)
Layers:
pages: src/pages/ (15 files) — assembly & routing, i18n (en + ru)
widgets: src/widgets/ (32 files, 21 widgets) — composite blocks, zero cross-imports
shared: src/shared/ (41 files) — ui(13) + config(22) + i18n(3) + lib
layouts: src/layouts/ (2 files) — BaseLayout
Conflict zones: none (0 files)
Parallel readiness: 9/10 — highly parallel
Sibling repos:
| Repo | Stack | Role | Forge? |
|---|---|---|---|
| acme-web | React 19.2+TanStack | frontend | ✓ 4.6 |
| acme-api | NestJS 11+Prisma | backend-api | ✓ 4.12 |
You're all set
Your AI is now architecture-aware. The dashboard shows your complete ecosystem:
● Forge Ecosystem Dashboard — acme-web
| Component | Version | Status |
|---|---|---|
| forge-core | v4.13.0 | Configured |
| forge-product | v3.9.0 | Configured |
| forge-qa | v3.7.0 | Configured |
| forge-tracker | v3.3.0 | Configured |
| forge-autopilot | v1.4.0 | Active (6 batches) |
| forge-worktree | v1.2.0 | Active |
Project Profile
| Property | Value |
|---|---|
| Stack | React 19 + TanStack Start + Tailwind v4 + Vite + TypeScript strict |
| Architecture | FSD (5 layers, 13 features) |
| Pipeline | Parallel, trunk-based, conventional commits |
| Git workflow | Trunk-based with worktrees |
| CI/CD | Vercel (SSR Docker) |
| Backend | acme-api (bidirectional propagation) |
Ecosystem is fully configured and up to date. Available actions:
– /forge:setup upgrade --check — check for updates
– /forge:tracker — task management via Notion
– /forge:autopilot — batch development pipeline
– /forge:qa — testing and coverage
What's next?
- Use your AI coding tool normally — it now understands your project structure
- Run
/forge:setupanytime to see the dashboard or reconfigure - Run
/forge:setup upgrade --checkto check for updates - Check the Usage Guide for the full command reference
Quick command reference
| Command | Description | Plan |
|---|---|---|
| /forge:setup | Setup wizard, dashboard, upgrade, reconfigure | Core+ |
| /forge:patch | Quick config patches without full setup | Core+ |
| /forge:product | Design features, epics, roadmap, strategy | Pro+ |
| /forge:qa | Test strategy, generation, coverage analysis | Pro+ |
| /forge:tracker | Task management (GitHub, Linear, ClickUp, Notion, Jira) | Pro+ |
| /forge:autopilot | Batch development with autonomous agent teams | Bundle |
| /forge:worktree-setup | Git worktree lifecycle templates | Bundle |
Ready to make your AI architecture-aware?
One-time purchase. 14-day money-back guarantee.
Get Forge — from €29 →Troubleshooting
Plugins not showing up?
Restart your AI session after installation. In Claude Code: /exit then claude. Verify with /plugins.
Setup wizard stuck?
The wizard saves progress after each gate. If interrupted, run /forge:setup again — it resumes from where you left off.
License activation issues?
Run forge --diagnostics and send the output to support@reumbra.com.