Agency Simulation
Agency Simulation is a production-house–style management game that runs directly inside VS Code. Build your advertising agency, take on projects, hire employees, and manage finances—all within your favorite code editor!
Support
If you find this extension useful and would like to support its development, consider buying me a coffee:
Table of Contents
Features
Interactive Agency Dashboard
View available projects, in-progress tasks, and completed jobs in a clean, VS Code–themed interface.
Project Management
• Generate new project opportunities
• Accept or reject incoming projects
• Track project timelines, budgets, and billing status
• Pay or collect deposits and invoices
Team & Hiring
• Recruit and fire employees
• Track each employee’s skills, salary, and productivity
• Upgrade office capacity to expand your workforce
Financial Simulation
• Manage your agency’s funds and reputation
• Pay daily salaries and operating costs
• Process billing, receive payments, and handle unexpected events
Random Events & Bonuses
• Experience occasional random events (bonus payouts, equipment failures, power outages)
• Level up employee skills through surprise training opportunities
Prerequisites
- VS Code (version 1.60.0 or higher)
- Node.js (version 14.x or higher)
- npm (comes bundled with Node.js)
Installation
Clone or download this repository
git clone https://github.com/banyapon/agency-empire.git
cd agency-empire
Install dependencies
npm install
Compile TypeScript (if applicable)
npm run compile
Launch the Extension in VS Code
- Open this folder in VS Code:
code .
- Press
F5 to open a new Extension Development Host window with Agency Simulation loaded.
(Optional) Package as a VSIX
If you want to install this extension locally or share it:
npm install -g vsce
vsce package
Then, install the generated .vsix file in VS Code via Extensions: Install from VSIX....
Usage
Open the Command Palette
Press Ctrl+Shift+P (Windows/Linux) or ⌘+Shift+P (macOS).
Start the Game
Type and select:
Agency Simulation: Start Game
This will launch the “Agency Simulation” webview panel.
Game Interface Overview
- Top Bar: Shows your current funds (USD), reputation, office level, and in-game date.
- Projects Pane:
- Available Projects: New opportunities you can accept.
- In Progress: Projects you’ve accepted, showing progress bars and remaining days.
- Completed Projects: Finished or billed-out projects awaiting payment.
- Team Pane:
- Your Employees: Each card shows employee name, salary, and skills.
- Hire Employee: Click to open a modal and recruit new candidates.
- Fire / Train: Manage existing staff.
- Upgrade Office: Spend money to raise your office level and unlock higher employee capacity.
- Notifications / Events: Live activity feed, showing project completions, payments, random events, and more.
Basic Gameplay Loop
- Generate New Projects: Click “Find New Project” in the Projects Pane to see fresh leads.
- Accept Projects: Reviewing budget, timeline, and billing terms—accept by paying any required deposit.
- Assign Employees: Your hired employees automatically work on in-progress projects.
- Monitor Progress: Progress bars fill as days pass (game speed is configurable).
- Billing & Payments: When a project completes, click “Process Billing” to generate invoices. Wait for due dates, then collect payments.
- Manage Finances: Pay daily salaries and monthly operating costs. Watch out for random events that can boost or drain your funds.
- Grow & Upgrade: Invest profits back into hiring more employees, training them, or upgrading your office to expand capacity.
Command Palette
Use Command Palette shortcuts to quickly access core commands:
Screenshots
Below are a few screenshots showing the in-game UI inside VS Code.
(Note: Replace the paths with your actual image locations in the repository.)
Main Dashboard

Shows available projects, team roster, and notifications pane.
Project Details & Progress

Inspect project budget, timeline, billing terms, and accept or process billing.
Extension Settings
This extension does not yet contribute any custom settings.
(Future versions may allow you to tweak “gameSpeed,” “startingFunds,” and “randomEventProbability” via VS Code Settings.)
Contributing
Contributions, bug reports, and feature requests are welcome!
- Fork this repository
- Create a new branch (
git checkout -b feature/my-feature )
- Commit your changes (
git commit -m "Add awesome feature" )
- Push to your branch (
git push origin feature/my-feature )
- Open a Pull Request and describe your changes
Please ensure your code follows the existing style, passes npm run lint , and that you update this README with any new instructions or screenshots.
Support
If you find this extension useful and would like to support its development, consider buying me a coffee:
License
This project is licensed under the MIT License. Feel free to use, modify, and distribute.
Enjoy building your Agency Empire—right from within VS Code!
| |