Package Exports

gapsyaicli
gapsyaicli/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (gapsyaicli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

GapsyAI CLI ⚡

AI CLI for Game Development

GapsyAI CLI is a powerful command-line tool designed to streamline game development workflows. Generate procedural assets, analyze scripts for bugs, and automate CI/CD checks directly from your terminal.

🚀 Quick Start

Installation

Install the CLI globally using npm:

npm install -g gapsyaicli

Note: If you are developing locally, run npm link inside the project directory.

Authentication

Initialize your connection by providing your GapsyAI API key:

gapsyai login

You can find your API key in the GapsyAI Dashboard settings.

❓ CLI Help

To see all available commands and options, run:

gapsyai --help

🛠 Commands

Generators (`gapsyai <command>`)

Generate game assets and logic using AI.

Command	Description	Example
`dialogue`	Generate NPC dialogues and player choices	`gapsyai dialogue`
`quest`	Generate side quests and objectives	`gapsyai quest`
`level`	Generate level design ideas and layouts	`gapsyai level`
`script`	Generate game scripts (C#, JavaScript, etc.)	`gapsyai script`
`idea`	Generate random game concepts and mechanics	`gapsyai idea`
`item`	Generate procedural items (weapons, magic)	`gapsyai item`
`enemy`	Generate enemy abilities and attack patterns	`gapsyai enemy`
`story`	Generate main storylines and plot twists	`gapsyai story`
`gameplay`	Generate core loops and progression systems	`gapsyai gameplay`
`skilltree`	Generate branching RPG skill trees	`gapsyai skilltree`
`asset-prompt`	Generate AI prompts for textures and assets	`gapsyai asset-prompt`
`jam`	Generate ideas for game jams	`gapsyai jam`
`trailer`	Generate YouTube scripts and marketing hooks	`gapsyai trailer`
`patchnotes`	Generate developer release notes from Git commits	`gapsyai patchnotes`

Analyzers (`gapsyai <command>`)

Analyze and optimize your project for performance and balance.

Command	Description	Example
`analyze`	Run a full project health scan	`gapsyai analyze`
`bug <file>`	Detect bugs and performance bottlenecks	`gapsyai bug player.cs`
`explain <file>`	Explain complex code logic in simple terms	`gapsyai explain player.cs`
`fix <file>`	Suggest and apply AI-driven code fixes	`gapsyai fix enemy.js`
`optimize <file>`	Suggest FPS and performance improvements	`gapsyai optimize player.cs`
`docs <file>`	Generate code documentation and API notes	`gapsyai docs player.cs`
`balance`	Analyze game difficulty and reward parity	`gapsyai balance`
`performance`	Profile FPS drops and memory leaks	`gapsyai performance`
`economy`	Analyze game economy and inflation risks	`gapsyai economy`
`assets`	Scan for duplicate and unused textures	`gapsyai assets`
`playtest`	Simulate player behavior and difficulty	`gapsyai playtest`
`multiplayer`	Help with lobby, matchmaking, and sync logic	`gapsyai multiplayer`
`monitor`	Run automated CI/CD quality checks	`gapsyai monitor`

Utilities

Manage your GapsyAI CLI state.

init: Initialize GapsyAI context for your project.
login: Authenticate with your GapsyAI API key.
brain <name>: Generate a structured NPC personality.
translate <file>: Localize dialogue files into ES, JP, CH.
usage: Check your AI usage and limits.
config: Manage CLI configuration and endpoints.
update: Update the CLI to the latest version.
version: Display the current version.

📖 Example Usage

`gapsyai dialogue`

Example Output:

NPC: Old Wizard
"The sword you seek lies beyond the cursed forest."

Choices:
1. Tell me more
2. Why is it cursed?
3. I will find it myself

🧠 AI Engine

GapsyAI CLI is powered by the GapsyAI Engine, an AI system designed specifically for game development workflows. It helps developers generate scripts, analyze game logic, design quests, and simulate gameplay mechanics directly from the terminal.

🎮 Supported Engines

GapsyAI works with most game development environments because it analyzes scripts and project files directly:

Unity (C#)
Unreal Engine (C++, Blueprints)
Godot (GDScript, C#)
GameMaker, RPG Maker, and more.

⚙️ Project Context

The CLI supports Enhanced Project Context. Run gapsyai init to create a .gapsy configuration file.

`.gapsy` Example:

{
  "name": "MyAwesomeRPG",
  "engine": "unity",
  "language": "csharp",
  "genre": "rpg",
  "target_platform": "pc",
  "scriptsPath": "./Assets/Scripts"
}

⚙️ Configuration

GapsyAI CLI stores local data in your user profile. The default API endpoint is http://localhost:8000/api. You can modify this via gapsyai config.

🛠 CI/CD Integration

Automate your quality checks using GitHub Actions:

- name: GapsyAI Analysis
  run: |
    npm install -g gapsyaicli
    gapsyai analyze
    gapsyai balance

🤝 Contributing

Contributions are welcome!

Fork the repository.
Create a new branch.
Submit a Pull Request.

📄 License

GapsyAI CLI is open-sourced software licensed under the MIT license.

gapsyaicli