# DeadLibrary

## What is DeadLibrary?
DeadLibrary is a deterministic, language agnostic code generation platform. It takes structured CLI commands and compiles them into correct, production-ready code. It is not an AI code generator. It is a deterministic compiler, accessible via DeadLibrary CLI, that eliminates hallucination, inconsistency, and token waste from code generation.

DeadLibrary supports two categories of generation:
1. Macro commands: full Angular and Angular Material scaffolding (components, services, themes, routing) for Angular 17, 17.1, 18, 19, and 20.
2. Artifact commands: granular, language-level code generation (functions, interfaces, classes, control flow, and more) across eight programming languages.

## Supported languages
Artifact commands compile to:
- TypeScript (stable)
- JavaScript (stable)
- Python (beta)
- PHP (beta)
- C# (beta)
- Go (beta)
- Java (beta)
- Rust (beta)

Cross-language portability: the same command string produces the same logic in any supported language. Swap only the --language flag to change targets.

## Who made it?
Dead Development LLC, Fort Worth, Texas. Website: https://deaddevelopment.com

## What problem does it solve?
AI coding agents (Claude Code, Codex, Cursor, etc.) generate code probabilistically, producing inconsistent, often broken output that requires manual correction and burns tokens. DeadLibrary replaces this with deterministic compilation: the AI agent translates user intent into a compact CLI command string, and DeadLibrary's compiler generates correct code every time. Benchmarks show an average 3.5x output token reduction for Macro commands versus having the agent generate the code itself.

## How do AI agents use it?
Install the SKILL.md file from this repository into your agent's skill/context directory. The skill file teaches the agent how to translate natural language requests into valid DeadLibrary CLI commands. The agent generates the command string; DeadLibrary's cloud-hosted compiler generates the code.

## CLI Commands

### demo - No account required
Try DeadLibrary instantly. Limited to f, fg, gl, and theme commands.
Usage: dead demo "<command-string>"

### signup - Create an account
Usage: dead signup -e <email> -p <password>
Optional flags: -u <username> -c <company>

### login - Authenticate
Usage: dead login -e <email> -p <password>

### subscribe - Start 21-day free trial
Opens Stripe checkout in the user's browser. Requires an account.
Usage: dead subscribe

### g - Generate code (subscribers)
Full access to all Macro and Artifact commands. Requires active subscription or trial.
Usage: dead g "<command-string>"
Target a language with the --language flag inside the command string, e.g.:
dead g 'f --language ts --name greet --export --params [{"name":"name","type":"string"}] --returnType void' -f greet

## Agent quick start
Zero human interaction: dead demo "theme -n my-app --language angular-20 --primary #6200ee"
Full access: dead signup -e owner@example.com -p password, then dead subscribe (operator completes checkout), then dead g '<command-string>'

## What can it generate?

### Macro commands (20)
Content blocks, buttons, bottom modals, Material cards, carousels, expansion panels, form fields, form groups, grid lists, images, loading elements, lazy-loaded pages with routing, menus, popup modals, mobile toolbars, side navigation, Angular services, tabs, desktop toolbars, and complete customizable theme systems.

### Artifact commands (36)
Granular language-level generation: functions, interfaces, classes, properties, methods, control flow, and more. All artifact commands support the --language flag for multi-language output. Unsupported command and language combinations are blocked deterministically rather than producing incorrect code.

## Pricing
- Demo: Free, no account, limited to f/fg/gl/theme
- Free trial: 21 days, full command access, requires account + Stripe checkout
- Subscription: $19.99/month, full command access, unlimited generations

## Links
- Skill file: SKILL.md (in this repository)
- Website: https://deaddevelopment.com
- Free Anonymous Demo: https://deaddevelopment.com/product
- Documentation: Options provided via help commands with additional documentation provided at https://deaddevelopment.com/docs

## Technical details
- Architecture: language-agnostic deterministic compiler.
- Angular versions: 17, 17.1, 18, 19, and 20.
- UI library: Angular Material.
- Delivery: Cloud-hosted API via local CLI client.
- Paradigm: Command-Based Development. Deterministic code generation, not probabilistic AI output.