🔥

Plyrium Forge Docs

v1.1.25 · Windows x64

Installation

Plyrium Forge installs like any standard Windows application.

Download the installer

Go to forge.plyrium.com/download and click Download for Windows. The installer is Plyrium-Forge-Setup.exe (~122 MB).

Run the setup wizard

Double-click the downloaded file. You'll see a standard Windows setup wizard:

Welcome — click Next
License agreement — read and accept
Install location — defaults to C:\Program Files\Plyrium Forge. Change it if you prefer.
Installing — files copy (a few seconds)
Finish — “Launch Plyrium Forge” is checked by default. Click Finish.

The installer creates a Start Menu shortcut and a Desktop icon, and registers the app in Add/Remove Programs for clean uninstallation.

Windows SmartScreen

Because the app is not yet code-signed, Windows may show a SmartScreen warning. Click More info → Run anyway. This is safe — the app is genuine.

💡No admin rights are required to run the app after installation. The installer itself requests admin to write to Program Files.

First launch & sign in

On first launch the app shows a sign-in screen.

Click Sign in with Plyrium

This opens your default browser at forge.plyrium.com/sign-in.

Create a free account or sign in

Click Create one free if you're new, or use Sign in with Google for one-click access. No credit card required for Solo (free).

Browser redirects back to the app

After signing in, your browser will redirect to the Plyrium Forge app automatically. You may see a dialog asking to open the app — click Open.

Solo plan — what's included

The Solo plan is free forever with no credit card required.

Terminal agents	4 terminals + 1 director
Projects	1 active project (delete to switch)
Teams	1 team
Memory vaults	✓ Per-project vaults
Auto-updater	✓ Silent background updates
Local & remote models	✓ Claude, Codex, Gemini, Ollama, Aider, OpenCode
Token savings routing	Studio+ only
Multi-agent missions	Studio+ only
Team seats	Team plan only

ℹ️When you hit the 4-agent limit the app shows an upgrade dialog. Dismiss it to keep working with your existing agents, or upgrade to Studio for unlimited.

Creating a team

Open the Setup Wizard

Click the 🚀 Setup button or press Cmd/Ctrl+Shift+N.

Choose Team Mode

Select Team on the Mode screen.

Configure your team

Pick a Project folder, give your team a name and mission goal, choose the AI provider for workers and director, and select a team size.

Solo plan sizes: up to 4 terminals (3-starter or 4-solo max). Larger presets are greyed out and require Studio+.

Launch

Click Launch. The wizard creates the team, spawns the director chat pane on the right, and opens your terminal agents on the left.

Agent roles explained

Director	Orchestrates the team via the chat panel. Receives your mission brief, breaks it into tasks, and routes work to workers.
Coder	Writes and edits code in an isolated git worktree branch.
Auditor	Reviews code, checks for bugs, validates tests.
Researcher	Searches the codebase, docs, or web to gather context for the team.
Project Manager	Manages the Ops Board, coordinates subtasks, tracks progress.

Git & worktree isolation

Plyrium Forge uses git worktrees to give each Coder agent its own isolated branch. This means multiple agents can edit different parts of the codebase simultaneously without stomping on each other.

ℹ️Git is recommended but not requiredto start. If Git isn't installed, the app will prompt you when it launches. Terminals work without Git — only worktree isolation is disabled.

If prompted, click Install Git for Windows to open the Git download page. Install it, then click Check again in the app — no restart needed.

Upgrading to Studio or Team

You can upgrade at any time from inside the app or from your account dashboard.

From the app: Hit any plan limit (e.g. try to add a 5th agent) and the upgrade dialog appears automatically.
From the web: Go to forge.plyrium.com/account → Upgrade section.

Studio — $19/mo	1 seat, unlimited agents, token savings, multi-agent missions
Team — $59/mo	Up to 5 seats, everything in Studio, shared workspaces

Uninstalling

Open Windows Settings → Apps → search for Plyrium Forge
Click Uninstall → follow the prompt

Or open Start Menu → Plyrium Forge → Uninstall Plyrium Forge.

ℹ️Your project files, memory vaults, and agent history stay in your project folders — uninstalling the app does not delete them.

FAQ

The installer shows a SmartScreen warning. Is it safe?

Yes. SmartScreen warns about any app that isn't yet code-signed. The app is genuine. Click More info → Run anywayto proceed. We're working on getting a code signing certificate.

Do I need Git installed?

Git is recommended for worktree isolation — the feature that lets multiple agents work independently without conflicts. Terminals work without it. The app will prompt you to install Git if it's not found.

Does the app send my code to the internet?

No. All orchestration runs locally. Your code never leaves your machine unless you explicitly configure an agent to push to a remote. The only network calls are to the AI provider you configure (Claude, Codex, etc.) and to forge.plyrium.com for authentication and tier checks.

Can I use my own AI API key?

Yes. Plyrium Forge is provider-agnostic — you bring your own API key. Supported: Claude Code, OpenAI Codex, Google Gemini, Ollama (local), Aider, OpenCode.

What is the Director?

The Director is a special agent that runs in the chat panel on the right side. You give it your mission goal; it breaks the work into tasks and routes them to your worker agents (Coders, Auditors, Researchers). It does not appear as a terminal in the grid.

How do I update the app?

The app checks for updates automatically at startup. If a new version is available, a notification appears. Click Download & Install and the update runs in the background. You can also manually check via Settings → About → Check for updates.

I have a question not covered here.

Email us at support@plyrium.com.

Still need help?Contact support →